referencedeep dive6 min4 Jul
Widget anatomy
A reference page bundle: the widgets/ folder laid out for both classes of widget — static and interactive — plus the _shared layer, to copy from.
tags
Guides by topic.
Every guide carries one or two curated tags: a narrow topic like #widgets or #palettes that cuts across rubrics and series. Click a tag — I'll gather every guide on the topic into one feed.
cloud · 17 tags · 10 guides
click a tag — the picks show up here · full feed is on the home page
referencedeep dive3 min27 Jun
Hotkeys and panels
Reference for reader controls: search and panel keys, focus mode, the View popover, and what's remembered locally.
handbookbasics · part 3 of 35 min20 Jun
Make it yours
Customization without a fork: a palette in one toml file, custom.css, hook partials, a section of your own and a second language.
handbookbasics · part 2 of 35 min13 Jun
Write your first guide
A guide scaffold in one command, the front matter canon, shortcodes, captions for code and a live widget in two touches.
handbookbasics · part 1 of 35 min6 Jun
Install and run
What the theme does, three ways to install it, the minimal config and the content layout — from an empty folder to a built site.
referencedeep dive11 min30 May
Kitchen sink: every component
A regression testbed: every shortcode, callout, code block, diagram and widget on one page.
handbookdeep dive6 min23 May
Covers, search and other build-time magic
What the theme does at build time: OG covers from a style folder, Pagefind full-text search and the version chip.
A palette is one file
Palettes as data: a toml file in data/themes/, out of which the build makes CSS blocks and the picker's swatches.
A series knows itself
How series work: a series is a folder in its rubric — and the “part N of M” kicker, the panel and the bridge count themselves at build time.
A guide is a folder
The theme's content model: an article is a leaf bundle, where its widgets, styles and cover sit next to the text.