mirror of
https://github.com/narrrl/narl-workspace.git
synced 2026-11-03 16:41:27 +01:00
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.
61 lines
2.0 KiB
Markdown
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.
|
|
|
|

|
|
|
|
| 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).
|