trentuna/asw
8
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
asw/content/_index.md
Ludo 15a6db9c0e
refactor: rename content types to semantic taxonomy 
- vault → notes (PKM-exported content)
- posts → articles (short-form, no TOC)
- papers → essays (long-form, with TOC)
- type: post → type: article (posts are just short articles)
- layouts/paper → layouts/essay
- 08a-paper.css → 08a-essay.css
- CSS: fix redundant li resets, remove role="main" from article,
  replace <small> prev/next labels, add console layout
- Update hugo.toml menus, internal URLs, front matter throughout
- Add docs/context.md, docs/css-refactor-plan.md
2026-04-11 13:36:58 +02:00

1.4 KiB
Raw Blame History

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="/notes/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 >}}