asw-v01: archive deferred content (packs, site, lab, legacy examples)
- 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:
parent
416fe2f180
commit
e47a9f4401
173 changed files with 11 additions and 5 deletions
4
archive/site/content/docs/packs/_index.md
Normal file
4
archive/site/content/docs/packs/_index.md
Normal file
|
|
@ -0,0 +1,4 @@
|
|||
---
|
||||
title: "Packs"
|
||||
weight: 50
|
||||
---
|
||||
29
archive/site/content/docs/packs/hugo.md
Normal file
29
archive/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
archive/site/content/docs/packs/nginx.md
Normal file
17
archive/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
archive/site/content/docs/packs/overview.md
Normal file
17
archive/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
archive/site/content/docs/packs/pandoc.md
Normal file
17
archive/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