Hugo Pack

Using ASW with Hugo — the theme, shortcodes, and configuration.

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.