Files
narl-workspace/docs/wiki/Diary.md
T
nvrl 176aad8c6f special: keys go to a tile, and Esc only ever leaves
Inside the special workspace the agenda and the calendar could only be
reached with Alt-h/j/k/l, which a desktop that binds Alt to its own windows
never lets through, and the same keys meant two things: t on the agenda put
the whole workspace away, t elsewhere went to it. Three esc buttons, one per
tile, all closed everything.

Now b, t and C only ever go to their tile, from anywhere. Tab and Shift-Tab
walk the tiles, as they walk the spaces elsewhere; l past the board's last
list goes on into the agenda, h in the agenda back to the board, j past its
end into the calendar. S toggles the workspace, and q and Esc leave it from
whichever tile — after leaving fullscreen first. The tile buttons are gone;
each tile's head shows its key instead, lit on the one with focus, and the
bar has a special pill beside the spaces.

A document opened from the workspace — a day of the calendar, an entry of
the agenda, today's entry, a card's notes — comes back to the tile it was
opened from on q.

The board tile shows the board of the space being browsed, or else the last
one shown, so coming from the diary, which has none, no longer leaves it
empty. Card and list actions follow the board on screen, not the browsed
space.
2026-10-21 15:53:24 +02:00

1.9 KiB

The diary

The space with the diary role is a journal. Each document in it is an entry, filed under the day it is about.

  • T (or :today) opens today's entry, and starts it when there is none.
  • [d and ]d step to the entry before or after the one open, by date.
  • :date 2026-10-01 files the open entry under another day.
  • :new 2026-10-01 starts an entry for a day that has passed.

Days are counted in WORKSPACE_TIMEZONE, the same as the evening reminder, so an entry written after midnight on a trip still lands on the right day.

The calendar

C (or :cal) shows the diary a month at a time, in the special workspace under the agenda.

The diary by month

key what it does
h / l a day back / forward
j / k a week forward / back
H / L a month back / forward
. today
Enter open the day's entry, or start one dated that day
q, Esc leave the special workspace; an entry opened here comes back on q

A dot marks a day with an entry. A number says how many when there are more than one.

The day template

When the diary has a templates folder with a document called day in it, every new entry starts from it: from T, o, the calendar, or a capture to the diary. For example:

## {{weekday}}

### What happened

### What I am thankful for

See Writing for the placeholders. The templates are not entries: they are not on the calendar and do not count as having written today.

On this day

The agenda ends with what you wrote on the same day in earlier years. j walks into them and Enter opens one.

The reminder

With mail set up, an evening reminder arrives at WORKSPACE_REMINDER_AT (20:00 by default) when nothing was written in the diary that day. See Backup and mail.