DDCcontrol website

This repository builds and deploys https://ddccontrol.github.io. The generated site combines the current releases of ddccontrol and ddccontrol-db.

Local build

Use released checkouts, or local repositories containing the release tags:

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -r requirements.txt
python scripts/build_site.py \
  --ddccontrol ../ddccontrol \
  --database ../ddccontrol-db \
  --output _site
python scripts/check_site.py _site
python -m http.server --directory _site 8000

xsltproc, the DocBook XML catalog and DocBook XSL stylesheets are required to build the versioned user guide. On Debian and Ubuntu they are provided by xsltproc, docbook-xml, docbook-xsl and xml-core.

Automatic updates

The Pages workflow runs on pushes to main, manual dispatch, a daily schedule, and release dispatches from both source repositories. It resolves the latest GitHub releases, checks out those exact tags, builds the site and deploys only the generated _site artifact.

The source repositories send release events with a repository secret named WEBSITE_DISPATCH_TOKEN. The token must be able to write to ddccontrol/ddccontrol.github.io; a fine-grained PAT or GitHub App installation token can be used. If the secret is absent, release publishing still succeeds and the daily website build remains the fallback.

Content ownership

• Program release notes and user documentation come from ddccontrol.
• Database release notes, contribution instructions and XML profiles come from ddccontrol-db.
• Layout, navigation and publishing behavior live in this repository.
• The imported historical website is retained under /legacy/ in the artifact.