The site is live. This first post doubles as a smoke test — if you can read this with a table of contents on the side, working code highlighting and a theme toggle in the corner, everything is wired up correctly.
How this site is built
It’s Hugo with the
PaperMod theme. Content is
plain Markdown under content/, and the theme lives in themes/PaperMod as a
git submodule so it can be updated independently of the writing.
Writing a new post
hugo new content posts/my-new-post.md
hugo server -D # preview at http://localhost:1313, drafts included
New posts start as draft: true. Flip that to false (or delete the line)
when the post is ready to go out — drafts are skipped by the production build.
Front matter worth knowing
| Key | What it does |
|---|---|
description | Used for SEO and the summary on list pages |
tags | Adds the post to /tags/ |
cover.image | Shows a header image on the post and in listings |
ShowToc | Toggles the table of contents for this post |
weight | Pins a post to the top of the list when set |
That’s the whole workflow: write Markdown, commit, push.