From 267a7b1bc80a1373bfae52f1515e009e68065673 Mon Sep 17 00:00:00 2001
From: Vigilio Desto <vigilio@trentuna.com>
Date: Fri, 10 Apr 2026 18:38:31 +0200
Subject: [PATCH] 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.
---
 content/_index.md                |  42 ++++++++++
 content/posts/asw-vocabulary.md  |  74 ++++++++++++++++
 content/posts/getting-started.md |  51 ++++++++++++
 hugo.toml                        | 139 ++++++++++++++++++++++++++++++-
 hugo_stats.json                  |  13 ++-
 layouts/partials/nav.html        |   5 +-
 layouts/shortcodes/callout.html  |  16 ++++
 layouts/shortcodes/wikilink.html |  20 +++++
 8 files changed, 353 insertions(+), 7 deletions(-)
 create mode 100644 content/_index.md
 create mode 100644 content/posts/asw-vocabulary.md
 create mode 100644 content/posts/getting-started.md
 create mode 100644 layouts/shortcodes/callout.html
 create mode 100644 layouts/shortcodes/wikilink.html

diff --git a/content/_index.md b/content/_index.md
new file mode 100644
index 0000000..5ac7fd7
--- /dev/null
+++ 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 >}}
diff --git a/content/posts/asw-vocabulary.md b/content/posts/asw-vocabulary.md
new file mode 100644
index 0000000..b38dde9
--- /dev/null
+++ 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.
diff --git a/content/posts/getting-started.md b/content/posts/getting-started.md
new file mode 100644
index 0000000..fc5fc7e
--- /dev/null
+++ 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 >}}
diff --git a/hugo.toml b/hugo.toml
index 9f35dd4..de8fd81 100644
--- a/hugo.toml
+++ b/hugo.toml
@@ -2,13 +2,146 @@ baseURL = 'https://asw.trentuna.com/'
 languageCode = 'en'
 title = 'ASW — Agentic Semantic Web'
 
+[params]
+  description = "Agentic Semantic Web — semantic HTML, data-* attributes, and CSS-only styling for the agentic era."
+
+[taxonomies]
+  tag = "tags"
+
+# ── Navigation menus ──────────────────────────────────────────────────
+[[menus.main]]
+  name = "Home"
+  url  = "/"
+  weight = 1
+
+[[menus.main]]
+  name = "Docs"
+  url  = "/docs/"
+  weight = 2
+
+[[menus.main]]
+  name = "Vault"
+  url  = "/vault/"
+  weight = 3
+
+[[menus.main]]
+  name = "Papers"
+  url  = "/papers/"
+  weight = 4
+
+[[menus.main]]
+  name = "Posts"
+  url  = "/posts/"
+  weight = 5
+
+[[menus.main]]
+  name = "Tags"
+  url  = "/tags/"
+  weight = 6
+
+# ── Docs sidebar menu ─────────────────────────────────────────────────
+# Parent entries (identifier set, no url) render as <small> section labels.
+# Child entries (parent set) render as sidebar nav links.
+
+[[menus.docs]]
+  name       = "Getting Started"
+  identifier = "docs-getting-started"
+  weight     = 10
+
+[[menus.docs]]
+  name   = "Introduction"
+  url    = "/docs/introduction/"
+  parent = "docs-getting-started"
+  weight = 11
+
+[[menus.docs]]
+  name       = "Core"
+  identifier = "docs-core"
+  weight     = 20
+
+[[menus.docs]]
+  name   = "Reset"
+  url    = "/docs/reset/"
+  parent = "docs-core"
+  weight = 21
+
+[[menus.docs]]
+  name   = "Semantic HTML"
+  url    = "/docs/on-semantic-html/"
+  parent = "docs-core"
+  weight = 22
+
+[[menus.docs]]
+  name   = "Data Attributes"
+  url    = "/docs/data-attributes/"
+  parent = "docs-core"
+  weight = 23
+
+[[menus.docs]]
+  name       = "Components"
+  identifier = "docs-components"
+  weight     = 30
+
+[[menus.docs]]
+  name   = "Layouts"
+  url    = "/docs/layouts/"
+  parent = "docs-components"
+  weight = 31
+
+[[menus.docs]]
+  name   = "Components"
+  url    = "/docs/components/"
+  parent = "docs-components"
+  weight = 32
+
+[[menus.docs]]
+  name   = "Accordion & Dialog"
+  url    = "/docs/accordion-dialog/"
+  parent = "docs-components"
+  weight = 33
+
+[[menus.docs]]
+  name   = "Navigation"
+  url    = "/docs/navigation/"
+  parent = "docs-components"
+  weight = 34
+
+[[menus.docs]]
+  name       = "Reference"
+  identifier = "docs-reference"
+  weight     = 40
+
+[[menus.docs]]
+  name   = "Charts"
+  url    = "/docs/charts/"
+  parent = "docs-reference"
+  weight = 41
+
+[[menus.docs]]
+  name   = "Syntax Highlighting"
+  url    = "/docs/chroma/"
+  parent = "docs-reference"
+  weight = 42
+
+[[menus.docs]]
+  name   = "ASW Vocabulary"
+  url    = "/posts/asw-vocabulary/"
+  parent = "docs-reference"
+  weight = 43
+
+# ── Markup settings ───────────────────────────────────────────────────
 [markup.goldmark.renderer]
   unsafe = true  # allow inline HTML in markdown (<mark>, <time>, etc.)
 
+[markup.tableOfContents]
+  startLevel = 2
+  endLevel   = 3
+  ordered    = false
+
 [markup.highlight]
-  noClasses = true
+  noClasses   = true
+  codeFences  = true
+  guessSyntax = true
 
 [build.buildStats]
   enable = true
-# build pipeline wired
-# e2e test 15:37:53Z
diff --git a/hugo_stats.json b/hugo_stats.json
index b261fad..d225b35 100644
--- a/hugo_stats.json
+++ b/hugo_stats.json
@@ -3,8 +3,10 @@
     "tags": [
       "a",
       "article",
+      "aside",
       "blockquote",
       "body",
+      "code",
       "dd",
       "div",
       "dl",
@@ -29,6 +31,7 @@
       "nav",
       "ol",
       "p",
+      "pre",
       "script",
       "section",
       "small",
@@ -47,23 +50,29 @@
     "classes": [
       "footnote-backref",
       "footnote-ref",
-      "footnotes"
+      "footnotes",
+      "highlight"
     ],
     "ids": [
       "a-taxonomy-of-agency",
+      "asw-data-attribute-vocabulary",
       "coda",
       "craft-as-methodology",
+      "example-full-page-skeleton",
       "fn:1",
       "fn:2",
       "fn:3",
       "fnref:1",
       "fnref:2",
       "fnref:3",
+      "getting-started-with-asw-hugo",
+      "installation",
       "principles-of-invisible-design",
       "the-dorveille-principle",
       "the-economics-of-attention",
       "the-table-of-hours",
-      "what-we-subtract"
+      "what-we-subtract",
+      "what-you-get"
     ]
   }
 }
diff --git a/layouts/partials/nav.html b/layouts/partials/nav.html
index e6528c7..e60a014 100644
--- a/layouts/partials/nav.html
+++ b/layouts/partials/nav.html
@@ -1,7 +1,8 @@
 <nav>
   <ul><li><a href="/"><strong>{{ .Site.Title }}</strong></a></li></ul>
   <ul>
-    <li><a href="/docs/">Docs</a></li>
-    <li><a href="/examples/">Examples</a></li>
+    {{- range .Site.Menus.main }}
+    <li><a href="{{ .URL }}"{{ if $.IsMenuCurrent "main" . }} aria-current="page"{{ end }}>{{ .Name }}</a></li>
+    {{- end }}
   </ul>
 </nav>
diff --git a/layouts/shortcodes/callout.html b/layouts/shortcodes/callout.html
new file mode 100644
index 0000000..a523948
--- /dev/null
+++ b/layouts/shortcodes/callout.html
@@ -0,0 +1,16 @@
+{{- /*
+  callout shortcode — wraps content in an ASW callout block.
+  
+  Usage:
+    {{< callout note >}}
+    Content here. Markdown is rendered.
+    {{< /callout >}}
+  
+  First positional param: callout type.
+  Valid types: note, warning, tip, info (maps to ASW data-callout attribute).
+  Default: note
+*/ -}}
+{{- $type := .Get 0 | default "note" -}}
+<aside data-callout="{{ $type }}">
+  {{ .Inner | markdownify }}
+</aside>
diff --git a/layouts/shortcodes/wikilink.html b/layouts/shortcodes/wikilink.html
new file mode 100644
index 0000000..0db6929
--- /dev/null
+++ b/layouts/shortcodes/wikilink.html
@@ -0,0 +1,20 @@
+{{- /*
+  wikilink shortcode — renders an internal link with ASW data-wikilink attribute.
+  
+  Usage:
+    {{< wikilink "Display Text" "/path/to/page/" >}}
+  
+  Param 0 (required): display text
+  Param 1 (optional): href path. Defaults to /display-text-slugified/
+  
+  Examples:
+    {{< wikilink "My Note" >}}
+    → <a href="/my-note/" data-wikilink>My Note</a>
+    
+    {{< wikilink "My Note" "/vault/my-note/" >}}
+    → <a href="/vault/my-note/" data-wikilink>My Note</a>
+*/ -}}
+{{- $text := .Get 0 -}}
+{{- $slug := $text | lower | replace " " "-" -}}
+{{- $href := .Get 1 | default (printf "/%s/" $slug) -}}
+<a href="{{ $href | relURL }}" data-wikilink>{{ $text }}</a>