KST4Contest Website Architecture

Goals

KST4Contest uses GitHub as the central source for code, documentation and releases.

The website is generated statically with Eleventy (11ty) and deployed to:

https://kst4contest.hamradioonline.de

Documentation Source

The existing github_docs/ directory remains the single source of truth for the manual.

It is used for:

GitHub Wiki
PDF manual generation
Website manual pages

Website Source

The website/ directory contains the Eleventy project.

Manual content must not be duplicated inside website/.

Marketing, SEO, news, screenshots and download pages belong into website/src/.

URL Structure

/
/features/
/download/
/screenshots/
/news/
/manual/
/manual/en/
/manual/de/
/faq/

Deployment

The generated static output is deployed to:

/srv/www/kst4contest/current

Nginx serves this directory.

Build Strategy

The production server keeps a checkout at /srv/git/kst4contest. A root cron job runs /srv/scripts/deploy-kst4contest-website.sh every five minutes. The script resets the checkout to origin/main, installs the locked npm dependencies, builds and validates the Eleventy site, and synchronises the result to /srv/www/kst4contest/current with the ownership required by Nginx.

This deploy path updates only the static website. Server-side analytics, Nginx, systemd, Logrotate, GeoIP, Basic Auth and Certbot configuration are installed and maintained separately as described in ops/analytics/README.md.

1.5 KiB Raw Blame History