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
51
content/posts/getting-started.md
Normal file
51
content/posts/getting-started.md
Normal file
|
|
@ -0,0 +1,51 @@
|
|||
---
|
||||
title: "Getting Started with ASW-Hugo"
|
||||
description: "How to set up the ASW-Hugo pack in your Hugo project."
|
||||
date: 2026-04-08
|
||||
tags: [setup, hugo, asw]
|
||||
ai-disclosure: "generated"
|
||||
ai-model: "claude-sonnet-4-5"
|
||||
ai-provider: "Anthropic"
|
||||
|
||||
---
|
||||
|
||||
# Getting Started with ASW-Hugo
|
||||
|
||||
The ASW-Hugo pack is a theme that outputs [Agentic Semantic Web](https://asw.trentuna.com/) semantic HTML from your Hugo Markdown content.
|
||||
|
||||
## Installation
|
||||
|
||||
1. Copy or symlink `packs/hugo/` from the ASW repo:
|
||||
```bash
|
||||
ln -s /path/to/agentic-semantic-web/packs/hugo/ themes/asw-hugo
|
||||
```
|
||||
|
||||
2. Set `theme = "asw-hugo"` in your `hugo.toml`.
|
||||
|
||||
3. Add tag taxonomy:
|
||||
```toml
|
||||
[taxonomies]
|
||||
tag = "tags"
|
||||
```
|
||||
|
||||
4. Wire ASW CSS:
|
||||
```bash
|
||||
cp /path/to/agentic-semantic-web/agentic.css \
|
||||
themes/asw-hugo/static/css/asw.css
|
||||
```
|
||||
|
||||
5. Build:
|
||||
```bash
|
||||
hugo
|
||||
```
|
||||
|
||||
## What you get
|
||||
|
||||
- Semantic HTML output: `<article>`, `<section data-layout="grid">`, `<aside data-callout>`
|
||||
- Tag navigation at `/tags/`
|
||||
- Callout blocks: `{{</* callout note */>}} ... {{</* /callout */>}}`
|
||||
- Wikilinks: `{{</* wikilink "Text" "/path/" */>}}`
|
||||
|
||||
{{< callout tip >}}
|
||||
The ASW-Hugo pack uses **system font stacks** by default — no external font loading required.
|
||||
{{< /callout >}}
|
||||
Loading…
Add table
Add a link
Reference in a new issue