feat: site restructure — layouts gallery, docs sections with inline demos

Navigation: Docs, Layouts, Lab (simplified from 6 items)

Layouts gallery: card grid showing all available page layouts
with live links to demo pages.

Docs restructure: 8 auto-generated sidebar sections
(Getting Started, Typography, Core, Content, Components,
Reference, Vault, Packs) with 20 new stub pages.
Each stub has inline HTML demos that ASW styles directly.

New Hugo layout template for layouts/ section.
Decap CMS nav updated.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Ludo 2026-04-11 18:24:27 +02:00
parent c0426ea746
commit 502b2e8266
Signed by: ludo
GPG key ID: F6E479DEFAB84D6E
28 changed files with 595 additions and 19 deletions

View file

@ -0,0 +1,4 @@
---
title: "Packs"
weight: 50
---

View file

@ -0,0 +1,29 @@
---
title: "Hugo Pack"
description: "Using ASW with Hugo — the theme, shortcodes, and configuration."
type: docs
weight: 52
date: 2026-04-11
tags: ["packs", "hugo"]
ai-disclosure: "generated"
ai-model: "claude-sonnet-4-6"
ai-provider: "Anthropic"
---
The Hugo pack (`packs/hugo/`) is a complete Hugo theme built on ASW. It maps Hugo's Markdown pipeline to semantic HTML that ASW styles automatically. This documentation site is built with it.
## Setup
Symlink or copy `packs/hugo/` into your Hugo project's `themes/` directory, then set `theme = "asw-hugo"` in `hugo.toml`. Enable unsafe HTML rendering so that raw HTML blocks in Markdown pass through:
```toml
[markup.goldmark.renderer]
unsafe = true
[markup.tableOfContents]
startLevel = 2
endLevel = 3
ordered = false
```
The pack provides layouts for `docs`, `blog`, and default page types. No additional configuration is required for basic use.

View file

@ -0,0 +1,17 @@
---
title: "nginx Pack"
description: "Serving ASW sites with nginx — config snippets and recommended settings."
type: docs
weight: 53
date: 2026-04-11
tags: ["packs", "nginx", "deploy"]
ai-disclosure: "generated"
ai-model: "claude-sonnet-4-6"
ai-provider: "Anthropic"
---
The nginx pack (`packs/nginx/`) provides ready-to-use server block snippets for static sites built with ASW. The snippets handle correct MIME types for `.css` files, cache headers, and clean URL rewrites so that `page/` serves `page/index.html` without explicit extensions.
Drop the relevant snippet into your nginx `conf.d/` directory and adjust the `root` path to point at your built site. No changes to ASW itself are required — the pack is purely a deployment convenience.
Stub — full configuration reference and examples will be added here.

View file

@ -0,0 +1,17 @@
---
title: "Packs Overview"
description: "What ASW packs are, how they extend the core stylesheet, and when to use them."
type: docs
weight: 51
date: 2026-04-11
tags: ["packs", "overview"]
ai-disclosure: "generated"
ai-model: "claude-sonnet-4-6"
ai-provider: "Anthropic"
---
Packs are thin integration layers that connect ASW to a specific tool or pipeline. They do not add new CSS — they configure the tool so that its output maps to the semantic HTML that ASW already styles.
The core `asw.css` works with any HTML. Packs handle the glue: Hugo shortcodes, nginx config snippets, Pandoc templates, and so on. Use a pack when you want zero-configuration output from a supported tool, and skip it if you are generating HTML yourself.
Available packs: **Hugo**, **nginx**, **Pandoc**. Each pack lives in `packs/<name>/` in the ASW repository.

View file

@ -0,0 +1,17 @@
---
title: "Pandoc Pack"
description: "Converting documents to ASW-styled HTML with Pandoc templates."
type: docs
weight: 54
date: 2026-04-11
tags: ["packs", "pandoc"]
ai-disclosure: "generated"
ai-model: "claude-sonnet-4-6"
ai-provider: "Anthropic"
---
The Pandoc pack (`packs/pandoc/`) contains an HTML5 template that wraps Pandoc output in the document structure ASW expects. Run Pandoc with `--template asw.html5` and the resulting file is styled by `asw.css` with no further changes.
This is particularly useful for converting Markdown, DOCX, or LaTeX source to a consistently styled HTML output — for example, generating agent reports, documentation pages, or meeting notes from plain-text inputs.
Stub — template reference and usage examples will be added here.