The Tinkering Mind

Personal blog

• Live site: https://weirdion.com
• Theme: themes/blowfish (git submodule)
• Built with Hugo, and the Blowfish theme.
• Site uses Umami hosted in the US.

Quick start

• Install Hugo Extended (match CI if possible: 0.148.2)
• Serve locally with drafts:

make serve

• Build static site:

make build

• Clean generated output:

make clean

Content

Posts are page bundles under content/posts/YYYY-MM-DD-slug/index.md. Use the default archetype (draft by default).

Configuration

• Root Hugo config: hugo.toml
• Site/language metadata: config/_default/languages.en.toml
• Theme/site params: config/_default/params.toml
• Menus: config/_default/menus.en.toml
• Markup & highlighting: config/_default/markup.toml

Deploy

Deployed via GitHub Actions to GitHub Pages:

• Workflow: .github/workflows/deploy-gh-pages.yml

Runbook

See the detailed operations guide: docs/RUNBOOK.md