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 · 2026-04-10 18:38:31 +02:00 · 267a7b1bc8
commit 267a7b1bc8
parent 4f2b0a67e1
8 changed files with 353 additions and 7 deletions
--- a/content/_index.md
+++ b/content/_index.md
@ -0,0 +1,42 @@
+---
+title: "Agentic Semantic Web"
+description: "Semantic HTML, data-* attributes, and CSS-only styling for the agentic era."
+date: 2026-04-10
+tags: ["asw", "semantic-web", "html"]
+
+---
+
+# Agentic Semantic Web
+
+**ASW** is a vocabulary and design system for the agentic era — semantic HTML with `data-*` attributes, CSS-only styling, no JavaScript required where a browser element already does the job.
+
+Built for sites generated by agents and read by agents. Navigable by humans.
+
+## What this is
+
+- [Docs](/docs/) — the ASW HTML vocabulary, layout system, and components
+- [Vault](/vault/) — live ASW notation: task lists, sessions, diffs, wikilinks
+- [Posts](/posts/) — writing and vocabulary reference
+- [Papers](/papers/) — longer-form thinking on the semantic web
+
+## The design principle
+
+No invented CSS classes. Every style target is either a semantic HTML element or a `data-*` attribute:
+
+```html
+<aside data-callout="note">This is a note.</aside>
+<section data-layout="grid">...</section>
+<a data-wikilink href="/vault/session/">session log</a>
+```
+
+Agents read the attributes. Humans read the content. The CSS connects them.
+
+## Try the shortcodes
+
+{{< callout note >}}
+This is a **note callout** rendered via the `callout` shortcode. Output: `<aside data-callout="note">`.
+{{< /callout >}}
+
+{{< callout tip >}}
+See the [Getting Started](/posts/getting-started/) post to wire ASW into your Hugo project.
+{{< /callout >}}
--- a/content/posts/asw-vocabulary.md
+++ b/content/posts/asw-vocabulary.md
@ -0,0 +1,74 @@
+---
+title: "ASW Data-Attribute Vocabulary"
+description: "The data-* attributes emitted by the ASW-Hugo pack."
+date: 2026-04-08
+tags: [asw, html, reference]
+ai-disclosure: "generated"
+ai-model: "claude-sonnet-4-5"
+ai-provider: "Anthropic"
+
+---
+
+# ASW Data-Attribute Vocabulary
+
+The ASW-Hugo pack emits these `data-*` attributes in its HTML output.
+
+| Attribute | Element | Meaning |
+|-----------|---------|---------|
+| `data-callout="note"` | `<aside>` | Note callout block |
+| `data-callout="warning"` | `<aside>` | Warning callout |
+| `data-callout="tip"` | `<aside>` | Tip callout |
+| `data-callout="info"` | `<aside>` | Info callout |
+| `data-wikilink` | `<a>` | Internal vault-style link |
+| `data-role="tag-cloud"` | `<nav>` | Tag navigation |
+| `data-layout="grid"` | `<section>` | Grid layout for list pages |
+| `data-tag` | `<a>` | Tag label on links |
+
+All styling comes from `asw.css` targeting these attributes — no CSS classes required.
+
+## Example: Full Page Skeleton
+
+A complete ASW page emitted by the Hugo pack looks like this:
+
+```html
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <title>Session Log · Vault</title>
+  <link rel="stylesheet" href="/css/asw.css">
+</head>
+<body>
+  <header>
+    <nav>
+      <ul><li><strong>Vault</strong></li></ul>
+      <ul>
+        <li><a href="/posts/">Posts</a></li>
+        <li><a href="/vault/">Vault</a></li>
+      </ul>
+    </nav>
+  </header>
+
+  <div data-layout="docs">
+    <aside>
+      <nav aria-label="Vault documentation" data-nav="sidebar">
+        <ul>
+          <li><a href="/vault/tasks/" aria-current="page">Tasks</a></li>
+          <li><a href="/vault/wikilinks/">Wikilinks</a></li>
+        </ul>
+      </nav>
+    </aside>
+
+    <article>
+      <hgroup>
+        <h1>Tasks</h1>
+        <p>Render task lists with semantic state.</p>
+      </hgroup>
+      <!-- page content -->
+    </article>
+  </div>
+</body>
+</html>
+```
+
+Notice: no `class` attributes anywhere. The layout, sidebar, and navigation styles are all driven by element semantics and `data-*` attributes.
--- a/content/posts/getting-started.md
+++ b/content/posts/getting-started.md
@ -0,0 +1,51 @@
+---
+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 >}}