Read config.toml, keys.toml and themes, and open them with :config (stage 8b)

The config folder now sets everything: config.toml the settings (now
also `theme` and `editor`), keys.toml the keys, and themes/<name>.toml
the theme, laid over the built-in one, so a theme only needs what it
changes. Each file is applied again a second after it's saved; a
mistake only drops its own line, and the status bar says what's wrong,
naming the file.

:config lists the three files with their folder; Enter hands the
terminal to your editor (the editor setting, $VISUAL, $EDITOR, else
notepad or vi), writing the file first if it's missing, with every
option at its default behind a #, explained (keys.toml lists every
command by name). :theme switches themes until cumulus quits, like
:set.

The built-in theme gets the named styles the user picked, each also put
on by its tag: question (yellow, dashed), important (red, thick) and done
(gray, its title faded); and link styles blocks and supports, whose
label shows on a link without its own. Themes can also set [modes],
[node], [root], [branch] and [link].

Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
skkeyeandClaude Opus 5.5 committed 2026-10-01 23:55:11 -04:00
1 parent f6dc4564aa
commit abe3dc1d84
26 files changed
+1683 -129

No files matched your search

+17
View File
@@ -42,6 +42,23 @@ saves a second after each change, reloads a file another program changed
A document open in another cumulus opens read-only. Each one reopens where you
left it.
## Settings, keys and themes
`:config` lists the three config files: `config.toml` (the settings),
`keys.toml` (your keys) and the theme's file. Enter opens one in your editor
(the `editor` setting, or `$VISUAL` / `$EDITOR`, or notepad / vi); the first
time, it's written with every option at its default behind a `#`, explained.
Take a `#` away, save, and cumulus applies it at once. Each file only needs
what it changes, and a mistake only skips its own line (the status bar says
what's wrong).
- `:set name=value` changes a setting until cumulus quits (`:set name?` shows
it, Tab lists them).
- `:theme name` switches to `themes/name.toml`, laid over the built-in theme:
a theme can say just `accent = "magenta"`.
- The built-in theme has named styles (`<Space>s`), also put on by tags:
`#question` (yellow, dashed), `#important` (red, thick), `#done` (faded).
## Keys
The plan for the everyday keys (all of them are in DESIGN.md):