# Documentation site

`build.py` renders the documentation section from the repository's Markdown,
the OpenAPI document and the screenshots into static HTML that follows the
dixon.cx page skeleton. Authored pages live in `pages/`; a page pulls a
repository document in with `{{include path [demote=N] [keep-title]}}` and the
API page uses `{{openapi}}`.

```
python3 -m venv .venv && .venv/bin/pip install markdown
.venv/bin/python docs/site/build.py /path/to/public_html/noema
```

The output uses the dixon.cx page shell and is indexable, with canonical,
Open Graph, Twitter and TechArticle JSON-LD metadata. Add any new chapter to the
`<!-- Noema -->` block of dixon.cx's `sitemap.xml`, then run
`scripts/site-seo-audit.py` there.