The site is built with Zensical using the existing mkdocs.yml configuration.
docker compose -f "docker-compose.yml" up -d --build
The site is served at http://localhost:9000.
-
Install Python 3.10 or newer.
-
Install the pinned dependencies:
pip install -r requirements.txt --require-hashes -
Run
zensical serveand open http://localhost:8000 to preview changes live.
Run zensical build --strict before opening a pull request; CI fails on any build warning, such as a broken link or anchor.
Edit requirements.in, then regenerate the hashed lock file:
uv pip compile --generate-hashes --universal --python-version 3.14 requirements.in -o requirements.txt