Skip to content

Publishing contract

The workbench is built for https://www.christianmlange.com/gme-1d/. The Contabo-side route and destination directory already exist — see CONTABO_ROUTE.md at the repo root for exactly what is deployed there and when it changed. Repository setup itself still never touches Contabo.

Local authoring

make site
.venv/bin/python -m mkdocs serve

The built site contains the main, supplementary, and combined PDFs; workbench pages; figure/evidence pages; and the complete rendered derivation archive. All pages carry noindex, nofollow, noarchive metadata.

qluster01 deployment

tools/publish_online.sh runs the build audit and publishes in one step — there is no separate gate to satisfy, so it can run whenever there is something worth publishing:

tools/publish_online.sh
# equivalent to:
#   make check
#   ~/bin/publish-docs.sh gme-1d ./site

Continuous publishing is provided by tools/gme-1d-online-publisher.service as a qluster user systemd unit. It runs tools/supervise_online_publisher.sh, which calls publish_online.sh in a loop (~60s). Installation and enablement are qluster01-side deployment steps, not repository setup steps.

Contabo remains a static target only: there must be no repo clone or build there.

Shared infrastructure

Changing the Caddy route or authentication policy changes shared Contabo infrastructure and requires explicit user approval — that has already happened for the current route (see CONTABO_ROUTE.md). Any further change to it (e.g. adding auth back) needs approval again.

Release transition

The drafting site is publicly accessible but deliberately carries noindex metadata while it remains a working document. At preprint release, the same surface can become the polished, indexable site and PDF release. Implementation, reviewer, and archival data packages remain private until separately scoped after the paper and final evidence panel are complete.