← Return to contents
Software  ·  2026·06·29

The Engine


AbstractThe Python static-site generator that builds this site. Markdown plus YAML frontmatter, Jinja2 templates, one build script. The document that typeset itself.

[ FIGURE 1 — HERO PHOTO ]
drop a board / object shot in here
Figure 1.— The Engine.

Every page on this site is a Markdown file with a little YAML on top. This generator walks the content folders, renders each file through a Jinja2 template, and writes plain HTML into dist/. No database, no framework, nothing to run on a server.

Building it rather than using a pre-made generator was the point: I wanted to understand every adjustment I make, and to own the whole pipeline from a note I type to the page you're reading.

Specification

LanguagePython 3
Dependenciesmarkdown, jinja2, pyyaml
OutputStatic HTML, no client-side JS
HostingCloudflare Pages
— End of Document —