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:
parent
c0426ea746
commit
502b2e8266
28 changed files with 595 additions and 19 deletions
4
site/content/docs/packs/_index.md
Normal file
4
site/content/docs/packs/_index.md
Normal file
|
|
@ -0,0 +1,4 @@
|
|||
---
|
||||
title: "Packs"
|
||||
weight: 50
|
||||
---
|
||||
29
site/content/docs/packs/hugo.md
Normal file
29
site/content/docs/packs/hugo.md
Normal 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.
|
||||
17
site/content/docs/packs/nginx.md
Normal file
17
site/content/docs/packs/nginx.md
Normal 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.
|
||||
17
site/content/docs/packs/overview.md
Normal file
17
site/content/docs/packs/overview.md
Normal 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.
|
||||
17
site/content/docs/packs/pandoc.md
Normal file
17
site/content/docs/packs/pandoc.md
Normal 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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue