hugolisted

# Hugo Site Standard (Hugo 0.164+, Hextra) Canonical guidelines for static sites with **Hugo extended** and the **Hextra** theme: documentation sites, project docs, and simple websites. Go applications stay on the [go-stack skill](../go-stack/SKILL.md) (GOTH); this skill is for content, not apps. ## 1. Core Stack - **Hugo Extended**: Required by Hextra. Install with mise's dedicated `hugo-extended` registry entry ([mise.toml](references/mise.toml)); `hugo version` must include `+extended`, or Hextra's `module.hugoVersion` check fails. - **Theme via Hugo Modules**: Import `github.com/imfing/hextra` as a Hugo Module — no git submodules, no vendored theme. Modules ride on Go (provisioned by mise): the theme version is pinned in `go.mod`/`go.sum`, fetched by `hugo mod get`, upgraded by `hugo mod get -u`. - **Hextra Feature Set** (all self-hosted, zero CDN references in the output): FlexSearch client-side search, dark/light/system theme toggle, Mermaid diagrams, **server-side KaTeX** (math renders at build time into fingerprinted, integrity-hashed assets), callout/card/tab shortcodes, per-page edit links, git-based last-modified dates. - **Task Runner & Hooks**: `mise.toml` ([mise.toml](references/mise.toml)) exposes the canonical vocabulary per the [mise skill](../mise/SKILL.md) — `install`, `format` (dprint), `check` (dprint + gitleaks + strict build), `test` (root-URL build + lychee offline link check), `build` (`--gc --minify`), `watch` (live-reload server). `lefthook.yml`