Guide

This site is built by site, a small Swift program that lives in this repository. It reads a folder of Markdown and writes a folder of HTML — and unlike most generators, the structure it builds is written in Swift rather than described in a configuration file.

That one decision explains most of what follows.

Contents

• Getting Started — building and previewing
• Site Anatomy — the site tree, and where navigation comes from
• Books — a folder of Markdown read as one document
• Theming — the palette, and how to override it
• Publishing — drafts, checks, and getting it online