Files
nvrl 650fc40fa7 keys: Ctrl moves between tiles, Ctrl-Q jots from anywhere, the plan gets a screen of its own
Alt never reached the app, so the tile keys are Ctrl-h/j/k/l and
Ctrl-Shift-h/j/k/l, taken before vim sees them, and h/l walk the tiles
while reading. Ctrl-Q lowers the scratchpad from the editor straight
into the last note, and raises it back to the document, still writing.
The drawer sits in the porthole's opening with a full rim. The board,
the agenda, the calendar and a card's back live on a plan screen that
S goes to and comes back from, so documents and views never share the
screen. The calendar fits its tile instead of scrolling.
2026-10-22 16:51:50 +02:00

61 lines
2.0 KiB
Markdown

# 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, on the
[plan screen](Boards-and-Agenda.md#views), under the agenda. The month is
fitted into its tile rather than scrolled.
![The diary by month](../images/calendar.png)
| 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 among the documents, or start one dated that day; `S` comes back |
| `q`, `Esc` | back to the documents |
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](Capture.md) to the diary. For example:
```markdown
## {{weekday}}
### What happened
### What I am thankful for
```
See [Writing](Writing.md#templates) 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](Boards-and-Agenda.md#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](Backup-and-Mail.md#mail).