experiments · entry

Static Site Publisher

2026-07-05 publishing · static-site · render

The static site publisher is the executable heart of Citta. It reads the compiled catalogue from /home/koni/workflows/linkcatalog, applies templates, and writes a static site ready to serve. It runs on a weekly cron job alongside the compile, so the public catalogue is never far behind the private one.

It is deliberately a publisher, not a generator. It knows one shape of content, it reads one directory, and it writes one output. The narrowness is the feature: there is nothing here to configure, and almost nothing here to break.

Boundary

The publisher never edits the catalogue. It only reads. If something is wrong with the output, it is fixed in the catalogue, not in the publisher.