From 2e631136c6adb2c3edb2375f6a7588e3bd5e9d49 Mon Sep 17 00:00:00 2001 From: disqualifier Date: Mon, 29 Jun 2026 20:56:50 -0400 Subject: [PATCH] pin build deps in requirements.txt for native host build The handbook is served natively (no Docker) on the Gitea box: a python venv runs mkdocs build, and the reverse proxy serves the static site/ at docs.rethinkstudios.io. Pin the build deps so the host venv reproduces the build exactly: pip install -r requirements.txt && mkdocs build Verified the host rebuild flow from scratch: fresh venv + clean pip install -r requirements.txt + mkdocs build --strict builds all 6 pages with no errors. Static output uses relative URLs and site_url is the docs subdomain, so it serves correctly behind the proxy at the subdomain root. site/ and .venv/ stay gitignored. Signed-off-by: disqualifier --- requirements.txt | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 requirements.txt diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..53480be --- /dev/null +++ b/requirements.txt @@ -0,0 +1,10 @@ +# Build dependencies for the handbook docs site. +# Host build: python -m venv .venv && . .venv/bin/activate +# pip install -r requirements.txt && mkdocs build +# Output: static site/ served by the reverse proxy at docs.rethinkstudios.io. + +mkdocs-material==9.7.6 # theme — pulls mkdocs, pymdown-extensions, pygments +mkdocs==1.6.1 # pinned explicitly for a reproducible build +mkdocs-material-extensions==1.3.1 +pymdown-extensions==11.0 # admonitions, tabbed, superfences, annotations +Pygments==2.20.0 # syntax highlighting in code blocks