# Journal your life Using Emacs Org

## 1 Introduction

Long time ago, I read a post about taking daily journal using Emacs. Until recently, I realized that I need to take journals on my work. So I read the post again and integrate the configuration into my .spacemacs.d.

In general, I use this journal system to note down my work. This journal system is simple and easy to use and maintain.

Here, I am not going to preach why you should keep a daily journal. Google will tell you more.

## 2 Install

If you want to Install the org-journal layer, just clone my .spacemacs.d there is a layer named zcljournal, which is forked from spacemacs-journal with a little modified.

To use this journal system, you need set org-journal-dir:

(setq org-journal-dir "~/.spacemacs.d/journal/")


## 3 Keys

### 3.1 Global Bindings

Key Binding Description
SPC a j j new journal entry
SPC a j v view journal of today
SPC a j s search journals within a specified time interval
SPC a j S search all journal for a string

### 3.2 Major Mode Bindings

Key Binding Description
SPC m j j new journal entry
SPC m j n next journal file
SPC m j p previous journal file
SPC m j s search the current journal file
SPC m j v read journal entry
SPC m j V display journal entry
SPC m j S search all journals
SPC m j w search calendar week
SPC m j m search calendar month
SPC m j y search calendar year

Also, you can replace the prefix SPC m with , which is more handy.

### 3.3 Calendar Mode Bindings

Key Binding Description
J j new journal entry
J v view an entry in a new buffer
J V view an entry but do not switch to it
J n go to next day with journal entries
J p go to previous day with journal entries
J S search in all entries of all time
J w search in all entries of the current week
J m search in all entries of the current month
J y search in all entries of the current year

## 4 Take a Journal

After setting, you can take journal anywhere and anytime. In the buffer not in Org mode, SPC a j j will generate and new journal entry. In Org mode, SPC m j j or , j j will also bring a new journal entry.

To browse your journal, you’d better in the Calendar buffer using calendar which I bind to SPC o C . In this buffer, press J there will be a menu popping up for you.

As you can see, the day with a journal is highlighted in yellow ( you can custom it to other colors ).

keys description
J n jump to next day having a journal
J p jump to previous day having a journal
J v display journal of current day

The key I use most is org-journal-search-forever which I bind to SPC a j S and you can search all your journals anytime and anywhere. You can also search a certain period by SPC a j s with which you need to enter the begin and end of the period in the minibuffer.
After a Period, say a month, there are quite a lot journals under the org-journal-dir . One day One journal.