asw/site/content/docs/getting-started/introduction.md at dd810f5a635e9fae047d70a9eee6a8788995a4fc

feat: auto-generated docs sidebar, Decap CMS, content migration infra

Docs restructure:
- Move flat docs into section subdirs (getting-started/, core/,
  components/, reference/) with _index.md for each
- Sidebar auto-generates from content structure — no manual menu entries
- New doc pages appear automatically when created in a section

Decap CMS:
- admin/index.html + config.yml for browser-based editing
- Local mode (npx decap-server) — no OAuth needed
- Collections for all content types: docs, articles, essays, notes, pages

Hugo head.html updated for new CSS layer filenames.
decap-server added as devDependency.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-11 18:02:34 +02:00

2.4 KiB

Raw Blame History

title

description

type

weight

date

What is ASW?

Agentic Semantic Web (ASW) is a standalone CSS framework designed for content generated by AI agents. It makes semantic HTML look good without requiring class names, utility tokens, or build steps.

One <link> tag. That is the entire installation.

<link rel="stylesheet" href="asw.css">

Why semantic HTML?

AI agents write HTML naturally — <article>, <section>, <nav>, <aside>, <figure>. They do not reliably reproduce class-based systems like Tailwind or Bootstrap without hallucinating class names or producing inconsistent output.

ASW meets agents where they are: structure conveys intent, and the stylesheet reads that structure.

<!-- This is a card. No class needed. -->
<article>
  <header>
    <h3>Session 2847</h3>
    <p data-text="dim">autonomous · 2026-04-02</p>
  </header>
  <p>Work completed this session.</p>
</article>

Installation

Copy asw.css to your project and link it:

cp asw.css static/css/asw.css

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <link rel="stylesheet" href="/css/asw.css">
  <title>My Site</title>
</head>
<body>
  <!-- Your semantic HTML here -->
</body>
</html>

No npm. No PostCSS. No configuration files.

Hugo integration

The ASW-Hugo pack (this theme) maps Hugo's Markdown output to ASW semantic HTML automatically. Drop the theme into any Hugo project:

ln -s /path/to/agentic-semantic-web/packs/hugo themes/asw-hugo

# hugo.toml
theme = "asw-hugo"

[markup.tableOfContents]
  startLevel = 2
  endLevel   = 3
  ordered    = false

What you get

Feature	How
Cards	`<article>`
Navigation	`<nav>`
Sidebar	`<aside>` in `data-layout="docs"`
Callouts	`<div data-callout="tip">`
Task lists	`<li data-task="done">`
Code blocks	`<pre><code>` with Chroma highlighting
Tables	`<table>` — striped, bordered automatically
Dark mode	System preference via `prefers-color-scheme`
Theming	Override `--accent` and `--gray-hue` in `:root`

2.4 KiB Raw Blame History