cheat sheet for org-journal

デフォルトでは、

(setq org-journal-time-format "%R")
(setq org-journal-time-prefix "** ")

となっていて、

** 13:20 秘密会議
会議の内容

のように、新しいエントリーが、第2レベルのヘッダーとして、時刻と共に作成される。しかし、業務日誌や研究日誌は、その日の終わりや、一段落したときに、振り返ってまとめて付けるものだから、この時刻は不要。また、必ずしもヘッダーは必要ないので、この二つの変数は両方とも空にする。

(setq org-journal-time-format "")
(setq org-journal-time-prefix "")  

その上で、日誌ファイルを、日常生活の記録、業務記録、研究記録の三つの部分に分け、それぞれについて記録する。やり方は、まず、次のような内容のテキストファイルを用意して、 org-journal-dir に置く。

** life

** work

** research

そして、このファイルを読み込む関数を次のように作成して、

(defun org-journal-date-format-func ()
"Custom function to journal date header"
(insert-file-contents "./template_for_daily")
)

ヘッダーが作られたときにこの関数が実行されるようにフックを設定する。

(add-hook 'org-journal-after-header-create-hook 'org-journal-date-format-func)

こうすると、毎日、最初にエントリーを作成したときに、 template_for_daily が読み込まれた状態で、新しいファイルが作成される。（ただし、 org-journal-file-type は 'daily 。）

そうすると毎日のファイルは以下のような形式で蓄積されていく。

* 202401
** life
- オムレツを焼く
- 出勤。サミットで白身魚フライ海苔弁当を買う。
- Xに電話

** work
- 会議
- 書類提出
- 面談

** research
- あの本のどこそこ
- あの論文を第2章まで

時間があれば、 M-x calendar ( [F2]にバインドしている)でカレンダーを起動して、 [ と ] で日付を行ったり来たりしながら過去の日誌を見直す。calendar-modeを参照

業務日誌はcalendar / diaryにしたので、通常の日誌はデフォルトに戻す。ただし、新しいエントリーに時刻が付くのは煩わしいので、 C-c j で日誌ファイルを開くごとに時刻を挿入し、その後は通常の - によるリストにする。これは、転記先でhtmlに変換するため。

  (setq org-journal-time-format "%R")
  (setq org-journal-time-prefix "** ")
(defun org-journal-entry-format-func ()
  "Custom function to journal entry"
  (insert "\n- ")
  )
(add-hook 'org-journal-after-entry-create-hook 'org-journal-entry-format-func)  

毎日のファイルの見た目は以下のようになる。

* 20240621
** 10:04 
  - 出汁巻き玉子。
  - 雨が降っていて、ときおり土砂降りになる。
  - 某講演会の報告書を提出。
** 21:09 
  - ジムは中止。雨がしっかり降っているし、体調的にも、無理して行くことはないと感じる。
  - standard-theme.elを試してみる。
  - 夕食は豚肩ロースのタマネギとキノコ炒め。

emacs標準。手軽さ、柔軟性、安定感。シンプル極まりないのが長所であり短所でもある。

標準では、 /.emacs.d/diary に記録されるが、変数 diary-file にファイルを指定すると、そこに記録される。たとえば、

(setq diary-file "~/Dropbox/calendar/my_diary.txt")

などと指定することができる。

cf. 32.10.1 The Diary File

入力コマンドは、まず i を叩いて、次に d で日誌の入力画面になる。

また、calendarバッファで s を叩けば、 diary-file 自体が開く。 また、 i d を使う場合には、後述の org-agendaとの関係に注意する必要がある。

cf. 32.10.4 Commands to Add to the Diary

calendar / diaryでは、とくに、定期的な予定の入力が簡単。

5/11 太郎の誕生日
Thursday 16:00 木曜会

などと書ける。これをorg-modeで書くと、

* 太郎の誕生日
<2000-05-11 +1y>

* 木曜会
<2024-05-02 Thursday 16:00 +1w>

などとなる。

org-captureは柔軟なので、日誌用のテンプレートを作ることもできる。

cf. 10.1.3 Capture templates

(setq org-capture-templates
         '(
           ("j" "Journal"
            entry (file+datetree "~/Dropbox/org/journal.org")
            "* %?"
            :empty-lines 1)
           )
         )

たとえば、このように設定すると、ターゲットのファイルの中に、以下のようなツリー状の構造でテキストが蓄積される。

* 2024
** 2024-05 May
*** 2024-05-11 Saturday

**** 1st entry of diary
bra bra bra

**** 2nd entry of diary
bro bro bro

denoteでは、denote-journal-extrasを使って日誌が書ける。というよりも、 _journal というキーワードを各ファイルに付加するだけで、denoteのシンプルなファイル管理システムの中に日誌も取り込んでしまう。calendarやorg-journalにはない独自の発想で、これはこれでアリなのかもしれない。

cf. 13. Keep a journal or diary

emacsのノート整理分野で一世を風靡した（現在もおそらくトップ）org-roamだが、日誌を書くためのコマンドも用意されている。新しいエントリーは、org-captureを使って入力し、終了コマンドで、本体の日誌ファイルに追記される。この点、日誌ファイルそれ自体を編集するorg-journalやdenoteとは操作性が異なる。

作業のログを取ると言うよりは、その時々の随想のようなものを、特にタイトルやテーマを決めずに書きためていくのに向いている。

読み直すためには、denoteと同じように、特別なコマンドで前日とか次の日とかに移動しながら読むことになるが、ここはorg-journalのように、calendarと連携させて欲しいところ。

cf. 13.3 org-roam-dailies

cf. Keep a Journal in Emacs with Org Roam

シンプルで軽いcalendar/diary、本格的な日誌システムのorg-journalの二つのキャラが際立っている。それ以外の、org-capture、denote-journal-extras、org-roam-dailiesはコンセプトが似ていて、日誌を通常のorgメモに統合しようというもの。

• 予定の管理は一元化することが鉄則であり、分散させると忘れるリスクが高まる。その意味で、予定は日誌とは別に管理することが望ましい。org-journalは、予定管理としても使えるが、これは極力避ける方針にする。
• 予定は、これまで通り agendaYY.org というファイルにまとめる。YYの部分は、西暦下二桁。入力は、org-captureまたはcalendarから行う。
• 日誌は、上記三つの選択肢があるので、それぞれ使い分けたい。ちょうど、現在、「生活上の記録」「業務上の記録」「研究日誌」という三つの分類で日誌をつけているので、この三つに対応させられないか。