Ludo
910b0e42a6
Separate framework source from website: - src/layers/ + src/main.css: CSS framework source (was assets/css/) - site/: Hugo website (content/, layouts/, hugo.toml) - dist/: built output (asw.css, asw.min.css) - vendor/open-props/: vendored dependency with version tracking - Hugo module mounts: dist/ → static, site runs from site/ Build: hugo --source site/ passes (105 pages). npm run build produces dist/asw.css. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
51 lines
1.2 KiB
Markdown
51 lines
1.2 KiB
Markdown
---
|
|
title: "Getting Started with ASW-Hugo"
|
|
description: "How to set up the ASW-Hugo pack in your Hugo project."
|
|
date: 2026-04-08
|
|
tags: [setup, hugo, asw]
|
|
ai-disclosure: "generated"
|
|
ai-model: "claude-sonnet-4-5"
|
|
ai-provider: "Anthropic"
|
|
|
|
---
|
|
|
|
# Getting Started with ASW-Hugo
|
|
|
|
The ASW-Hugo pack is a theme that outputs [Agentic Semantic Web](https://asw.trentuna.com/) semantic HTML from your Hugo Markdown content.
|
|
|
|
## Installation
|
|
|
|
1. Copy or symlink `packs/hugo/` from the ASW repo:
|
|
```bash
|
|
ln -s /path/to/agentic-semantic-web/packs/hugo/ themes/asw-hugo
|
|
```
|
|
|
|
2. Set `theme = "asw-hugo"` in your `hugo.toml`.
|
|
|
|
3. Add tag taxonomy:
|
|
```toml
|
|
[taxonomies]
|
|
tag = "tags"
|
|
```
|
|
|
|
4. Wire ASW CSS:
|
|
```bash
|
|
cp /path/to/agentic-semantic-web/agentic.css \
|
|
themes/asw-hugo/static/css/asw.css
|
|
```
|
|
|
|
5. Build:
|
|
```bash
|
|
hugo
|
|
```
|
|
|
|
## What you get
|
|
|
|
- Semantic HTML output: `<article>`, `<section data-layout="grid">`, `<aside data-callout>`
|
|
- Tag navigation at `/tags/`
|
|
- Callout blocks: `{{</* callout note */>}} ... {{</* /callout */>}}`
|
|
- Wikilinks: `{{</* wikilink "Text" "/path/" */>}}`
|
|
|
|
{{< callout tip >}}
|
|
The ASW-Hugo pack uses **system font stacks** by default — no external font loading required.
|
|
{{< /callout >}}
|