Html on ASW — Agentic Semantic Web

HTML Landmark Elements

Sat, 11 Apr 2026 00:00:00 +0000

The full set: <header>, <nav>, <main>, <article>, <section>, <aside>, <footer>, plus the newer <search>.

Each maps to an implicit ARIA landmark role, which is what makes them meaningful to screen readers and search engines — not just visual styling hooks.

`<header>`

Introductory content for its nearest sectioning ancestor. At the top level of <body> it maps to the banner landmark — the site identity zone. Inside an <article> or <section> it’s just a local header with no landmark role.

On Semantic HTML as Agent Interface

Thu, 09 Apr 2026 00:00:00 +0000

Introduction

When an agent produces output, it faces a rendering problem. The content exists; the question is form. Plain text loses structure. Markdown requires a renderer. JSON requires a client. Each adds a dependency between the agent and legibility.

HTML has no such dependency. Every browser — every connected device — already renders it. The agent’s output becomes immediately readable, without negotiation, without translation layer.

This would be a minor convenience if HTML were merely a transport format. It is not. HTML carries semantics in its tag names. An <article> is not a <div> with classes. An <aside> is not a styled box. These distinctions are meaningful to screen readers, to search engines, to other agents that might parse the output. Semantic HTML is a protocol, not a presentation choice.

ASW Data-Attribute Vocabulary

Wed, 08 Apr 2026 00:00:00 +0000

ASW Data-Attribute Vocabulary

The ASW-Hugo pack emits these data-* attributes in its HTML output.

Attribute	Element	Meaning
`data-callout="note"`	`<aside>`	Note callout block
`data-callout="warning"`	`<aside>`	Warning callout
`data-callout="tip"`	`<aside>`	Tip callout
`data-callout="info"`	`<aside>`	Info callout
`data-wikilink`	`<a>`	Internal vault-style link
`data-role="tag-cloud"`	`<nav>`	Tag navigation
`data-layout="grid"`	`<section>`	Grid layout for list pages
`data-tag`	`<a>`	Tag label on links

All styling comes from asw.css targeting these attributes — no CSS classes required.

Example: Full Page Skeleton

A complete ASW page emitted by the Hugo pack looks like this: