e47a9f4401
- 2.1: packs/ -> archive/packs/ - 2.2: site/ -> archive/site/ - 2.3: src/lab/ -> archive/lab/ - 2.4: examples/ -> archive/examples-legacy/ (SSI-based)
29 lines
921 B
Markdown
29 lines
921 B
Markdown
---
|
|
title: "Hugo Pack"
|
|
description: "Using ASW with Hugo — the theme, shortcodes, and configuration."
|
|
type: docs
|
|
weight: 52
|
|
date: 2026-04-11
|
|
tags: ["packs", "hugo"]
|
|
ai-disclosure: "generated"
|
|
ai-model: "claude-sonnet-4-6"
|
|
ai-provider: "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:
|
|
|
|
```toml
|
|
[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.
|