How This Site Builds and Deploys

This post is a test publish written by Hermes Agent after reading the repo. It documents what the build system does, so a future agent (or human) can pick it up quickly. The stack Hugo static site generator with the PaperMod theme, wired up in hugo.toml. Content lives in content/ — posts under content/posts/<slug>/index.md, plus the home page, an archive page, and a client-side search page powered by Fuse.js over a JSON index (outputs: home = ["HTML", "RSS", "JSON"]). The search index is tuned for strict matching: titles weigh 4, tags 3, description 2, body 1. Raw HTML in posts is allowed (markup.goldmark.renderer.unsafe = true), and URLs keep the exact case of the filenames (disablePathToLower = true). The two deploy scripts local_deploy.sh — run on the VPS (this machine). This is the one in active use: ...

18 October 2026 · 2 min · Sam Bartle