Public Access
twislaandClaude Opus 5.5
34e6714785
Every screen's keys are constant tables in lib/core/src/app_keys.h (52 of them, each under an `// id: Title` comment). An App's help() picks the table of the state it is in. site/tools/gen_dev_docs.py reads the same file and writes site/data/keys.toml; the `keys` shortcode shows a screen's tables on its guide page, and /guide/keys/ shows all of them. The Site job fails when the data file is out of date or a page asks for a table that doesn't exist, and now also runs when app_keys.h changes. A key added to an App shows up on the website without anyone editing a page. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT
44 lines
2.2 KiB
Markdown
44 lines
2.2 KiB
Markdown
+++
|
|
title = "Notes"
|
|
description = "Plain text notes on the SD card, with no save key: the editor saves for you, and a power cut never costs the note."
|
|
weight = 7
|
|
[extra]
|
|
tag = "Notes"
|
|
screens = ["notes.png"]
|
|
+++
|
|
|
|
Notes are plain text files in `/notes` on the SD card. They are ordinary `.txt` files: you can read them on a computer too.
|
|
|
|
## The list
|
|
|
|
Each note shows its first line and its date, newest first. <kbd>s</kbd> switches to sorting by file name.
|
|
|
|
| Key | Does |
|
|
|---|---|
|
|
| <kbd>n</kbd> | Starts a new note |
|
|
| <kbd>Enter</kbd> | Opens the note |
|
|
| <kbd>r</kbd> | Renames its file |
|
|
| <kbd>d</kbd> | Deletes it, after asking |
|
|
|
|
## The editor
|
|
|
|
Type. <kbd>Enter</kbd> starts a line and <kbd>Del</kbd> deletes backwards. <kbd>Fn</kbd> with the arrow keys moves the cursor through the wrapped text, <kbd>Ctrl</kbd>+<kbd>A</kbd> and <kbd>Ctrl</kbd>+<kbd>E</kbd> go to the start and the end of the line, <kbd>Tab</kbd> types two spaces, and the compose key gives accents as everywhere.
|
|
|
|
**There is no save key.** The note is written five seconds after your last key, when you press Back, when you leave the App, when the screen turns off and before the device powers off. The top line says `typing` or `saved`.
|
|
|
|
Each save writes a temporary file and then puts it in the note's place, so a power cut costs a few seconds of typing and never the note. If a save was cut short, opening the note offers its copy back.
|
|
|
|
## Names
|
|
|
|
A new note has no file until you type something. The file is then named after its first line (`shopping-list.txt`), or `note-<date>-<time>.txt` if that line gives no usable name.
|
|
|
|
## Limits
|
|
|
|
A note holds up to **16 KB** while it is edited. A bigger text file opens read-only in the [Storage App](/guide/storage/); editing a file of any size is planned. In Storage, <kbd>e</kbd> on a text file opens it in the same editor, anywhere on the card, unless the file is read-only. Notes are never offered for deletion by the clean-up.
|
|
|
|
## The keys, as the device lists them
|
|
|
|
What <kbd>Fn</kbd> + <kbd>h</kbd> shows on these screens. These tables are generated from the firmware's own lists, so they are always the current ones.
|
|
|
|
{{ keys(scopes=["notes", "notes-editor", "notes-name"]) }}
|