asw/content/_index.md
Vigilio Desto 267a7b1bc8
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.4 KiB

title description date tags
Agentic Semantic Web Semantic HTML, data-* attributes, and CSS-only styling for the agentic era. 2026-04-10
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 — the ASW HTML vocabulary, layout system, and components
  • Vault — live ASW notation: task lists, sessions, diffs, wikilinks
  • Posts — writing and vocabulary reference
  • 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:

<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 post to wire ASW into your Hugo project. {{< /callout >}}