Port homepage, posts section, shortcodes; update hugo.toml menus

- content/_index.md: homepage with site description and callout examples
- content/posts/asw-vocabulary.md: ASW data-* attribute vocabulary reference
- content/posts/getting-started.md: ASW-Hugo setup guide (updated URLs)
- hugo.toml: add params, taxonomies, menus (main + docs sidebar), ToC settings
- layouts/partials/nav.html: dynamic Hugo menu rendering (was hardcoded)
- layouts/shortcodes/callout.html, wikilink.html: ported from asw-hugo theme

Closes: asw#17, asw#13, asw#11, asw#16
28 pages build clean, deploy confirmed at port 8000.

2026-04-10 18:38:31 +02:00

1.2 KiB

Raw Blame History

title

description

date

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

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

ln -s /path/to/agentic-semantic-web/packs/hugo/ themes/asw-hugo

Set theme = "asw-hugo" in your hugo.toml.
Add tag taxonomy:
```
[taxonomies]
  tag = "tags"
```

Wire ASW CSS:

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

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

1.2 KiB Raw Blame History

Getting Started with ASW-Hugo

Installation

What you get

1.2 KiB

Raw Blame History