asw/content/articles/getting-started.md
Ludo 15a6db9c0e
refactor: rename content types to semantic taxonomy
- vault → notes (PKM-exported content)
- posts → articles (short-form, no TOC)
- papers → essays (long-form, with TOC)
- type: post → type: article (posts are just short articles)
- layouts/paper → layouts/essay
- 08a-paper.css → 08a-essay.css
- CSS: fix redundant li resets, remove role="main" from article,
  replace <small> prev/next labels, add console layout
- Update hugo.toml menus, internal URLs, front matter throughout
- Add docs/context.md, docs/css-refactor-plan.md
2026-04-11 13:36:58 +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 >}}