asw/archive/site/content/docs/packs/hugo.md
exe.dev user e47a9f4401 asw-v01: archive deferred content (packs, site, lab, legacy examples)
- 2.1: packs/ -> archive/packs/
- 2.2: site/ -> archive/site/
- 2.3: src/lab/ -> archive/lab/
- 2.4: examples/ -> archive/examples-legacy/ (SSI-based)
2026-06-07 10:39:21 +02:00

921 B

title description type weight date tags ai-disclosure ai-model ai-provider
Hugo Pack Using ASW with Hugo — the theme, shortcodes, and configuration. docs 52 2026-04-11
packs
hugo
generated claude-sonnet-4-6 Anthropic

The Hugo pack (packs/hugo/) is a complete Hugo theme built on ASW. It maps Hugo's Markdown pipeline to semantic HTML that ASW styles automatically. This documentation site is built with it.

Setup

Symlink or copy packs/hugo/ into your Hugo project's themes/ directory, then set theme = "asw-hugo" in hugo.toml. Enable unsafe HTML rendering so that raw HTML blocks in Markdown pass through:

[markup.goldmark.renderer]
  unsafe = true

[markup.tableOfContents]
  startLevel = 2
  endLevel   = 3
  ordered    = false

The pack provides layouts for docs, blog, and default page types. No additional configuration is required for basic use.