mirror of
https://github.com/narrrl/narl-workspace.git
synced 2026-11-04 08:57:00 +01:00
nvrl
176aad8c6f
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.
61 lines
1.9 KiB
Markdown
61 lines
1.9 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, in the
|
|
[special workspace](Boards-and-Agenda.md#the-special-workspace) under the
|
|
agenda.
|
|
|
|
|
|
|
|
| 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](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).
|