日記ファイルとは、特定の日付に関連付けられた出来事を記録するファイルのことです。日記ファイルの名前は変数
diary-file で指定されます。デフォルトは ~/.emacs.d/diary ですが、旧バージョンとの互換性のため、Emacs は ~/diary が存在する場合はそちらを使用します。
日記ファイルの各エントリは1つの出来事を記述するもので、1行以上で構成されます。エントリは常に左端の余白にある日付指定から始まります。エントリの残りの部分は、単にその出来事を記述するテキストです。エントリが複数行にわたる場合、2行目以降は、それが前のエントリの続きであることを示すために、先頭に空白文字を置く必要があります。有効な日付で始まらず、かつ前のエントリの続きでもない行は無視されます。以下に例を示します:
12/22/2015 Twentieth wedding anniversary!
10/22 Ruth's birthday.
* 21, *: Payday
Tuesday--weekly meeting with grad students at 10am
Supowit, Shen, Bitner, and Kapoor to attend.
1/13/89 Friday the thirteenth!!
thu 4pm squash game with Lloyd.
mar 16 Dad's birthday
April 15, 2016 Income tax due.
* 15 time cards due.
この例では、ほとんどの項目のイベント説明を揃えるために余分なスペースを入れています。このような書式設定は、あくまで好みの問題です。
また、日記の1行目を日付や曜日のみ(その後に空白や句読点を入れない)とする形式も使えます。例えば:
02/11/2012
Bill B. visits Princeton today
2pm Cognitive Studies Committee meeting
2:30-5:30 Liz at Lawrenceville
4:00pm Dentist appt
7:30pm Dinner at George's
8:00-10:00pm concert
シンプルな日記表示(日記表示を参照)を使用すると、このエントリの見た目が変わります。シンプルな日記表示では、冒頭の日付行が省略され、続きの行のみが表示されます。この形式のエントリは、1日分のみを表示する場合にはよりすっきりと見えますが、複数日分のエントリを表示させる場合には混乱を招く可能性があります。