Packs on ASW — Agentic Semantic Web

Packs Overview

Sat, 11 Apr 2026 00:00:00 +0000

Packs are thin integration layers that connect ASW to a specific tool or pipeline. They do not add new CSS — they configure the tool so that its output maps to the semantic HTML that ASW already styles.

The core asw.css works with any HTML. Packs handle the glue: Hugo shortcodes, nginx config snippets, Pandoc templates, and so on. Use a pack when you want zero-configuration output from a supported tool, and skip it if you are generating HTML yourself.

Hugo Pack

Sat, 11 Apr 2026 00:00:00 +0000

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:

[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.

nginx Pack

Sat, 11 Apr 2026 00:00:00 +0000

The nginx pack (packs/nginx/) provides ready-to-use server block snippets for static sites built with ASW. The snippets handle correct MIME types for .css files, cache headers, and clean URL rewrites so that page/ serves page/index.html without explicit extensions.

Drop the relevant snippet into your nginx conf.d/ directory and adjust the root path to point at your built site. No changes to ASW itself are required — the pack is purely a deployment convenience.

Pandoc Pack

Sat, 11 Apr 2026 00:00:00 +0000

The Pandoc pack (packs/pandoc/) contains an HTML5 template that wraps Pandoc output in the document structure ASW expects. Run Pandoc with --template asw.html5 and the resulting file is styled by asw.css with no further changes.

This is particularly useful for converting Markdown, DOCX, or LaTeX source to a consistently styled HTML output — for example, generating agent reports, documentation pages, or meeting notes from plain-text inputs.

Stub — template reference and usage examples will be added here.