trentuna/asw
8
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

asw-v01: archive deferred content (packs, site, lab, legacy examples)

Browse source 
- 2.1: packs/ -> archive/packs/
- 2.2: site/ -> archive/site/
- 2.3: src/lab/ -> archive/lab/
- 2.4: examples/ -> archive/examples-legacy/ (SSI-based)
This commit is contained in:
exe.dev user 2026-06-07 10:39:21 +02:00
parent 416fe2f180
commit e47a9f4401
173 changed files with 11 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

4
archive/site/content/docs/getting-started/_index.md Normal file
View file

@ -0,0 +1,4 @@
---
title: "Getting Started"
weight: 10
---

29
archive/site/content/docs/getting-started/getting-started.md Normal file
View file

@ -0,0 +1,29 @@
---
title: "Quick Start"
description: "Get ASW running in five minutes: one CSS file, semantic HTML, no build step."
type: docs
weight: 12
date: 2026-04-11
tags: ["getting-started", "installation"]
ai-disclosure: "generated"
ai-model: "claude-sonnet-4-6"
ai-provider: "Anthropic"
---
Drop `asw.css` into your project, add one `<link>` tag, and write semantic HTML. No npm, no build pipeline, no configuration files required.
## Inline Demo
<div data-demo>
<nav>
<a href="#">Home</a> ·
<a href="#">Docs</a> ·
<a href="#">About</a>
</nav>
<main>
<article>
<header><h2>Page title</h2></header>
<p>This is an <code>&lt;article&gt;</code> inside <code>&lt;main&gt;</code>, next to a <code>&lt;nav&gt;</code>. ASW styles all three with no classes.</p>
</article>
</main>
</div>

96
archive/site/content/docs/getting-started/introduction.md Normal file
View file

@ -0,0 +1,96 @@
---
title: "Introduction"
description: "What ASW is, why it exists, and how to drop it into any project."
type: docs
weight: 10
date: 2026-04-09
tags: ["introduction", "getting-started", "reference"]
ai-disclosure: "generated"
ai-model: "claude-sonnet-4-5"
ai-provider: "Anthropic"
---
## 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.
```html
<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.
```html
<!-- 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:
```bash
cp asw.css static/css/asw.css
```
```html
<!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:
```bash
ln -s /path/to/agentic-semantic-web/packs/hugo themes/asw-hugo
```
```toml
# 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` |