asw/site/content/articles/getting-started.md
Ludo 910b0e42a6
refactor: restructure repo into src/ site/ dist/ vendor/ packs/
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>
2026-04-11 15:12:42 +02:00

1.2 KiB

title description date tags ai-disclosure ai-model ai-provider
Getting Started with ASW-Hugo How to set up the ASW-Hugo pack in your Hugo project. 2026-04-08
setup
hugo
asw
generated claude-sonnet-4-5 Anthropic

Getting Started with ASW-Hugo

The ASW-Hugo pack is a theme that outputs Agentic Semantic Web semantic HTML from your Hugo Markdown content.

Installation

  1. Copy or symlink packs/hugo/ from the ASW repo:

    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:

    [taxonomies]
      tag = "tags"
    
  4. Wire ASW CSS:

    cp /path/to/agentic-semantic-web/agentic.css \
       themes/asw-hugo/static/css/asw.css
    
  5. Build:

    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 >}}