httk.org website

The website for httk (served at http://httk.org).

The site is generated by publish_static.py (using the httk₂ httk-serve static site generator, imported as httk.serve.web) from two independent source trees into public/ (git-ignored output):

• src/ → public/ — the httk₂ main site (the current main version).
• src-v1/ → public/v1/ — the legacy httk version 1 subsite, served at /v1/. It keeps v1-accurate content, its own reduced-nav templates with a legacy banner, and links docs to https://olddocs.httk.org.

The main src/ tree uses native Markdown (config.md and content/*.md), while src-v1/ remains the legacy .httkweb subsite; both trees keep their own templates/ and static/ directories.

The httk-serve generator is declared as a dependency in pyproject.toml. Install it (preferably into a virtual environment) and build both trees:

pip install .
python3 ./publish_static.py

Then open public/index.html in your browser.

A Makefile provides the common targets:

make generate      # build public/ (and public/v1/) with publish_static.py
make serve         # run the dynamic dev server (serve_dynamic.py) on :8080
make serve_static  # build, then serve public/ over http.server on :8080
make clean