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.
This commit is contained in:
parent
4f2b0a67e1
commit
267a7b1bc8
8 changed files with 353 additions and 7 deletions
42
content/_index.md
Normal file
42
content/_index.md
Normal file
|
|
@ -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 >}}
|
||||
Loading…
Add table
Add a link
Reference in a new issue