From 838c6fda0a9065178a7bc00e99cc99d5251ff8d6 Mon Sep 17 00:00:00 2001 From: SirTobyB Date: Sat, 12 Sep 2026 13:08:30 +0200 Subject: [PATCH 01/12] =?UTF-8?q?Ger=C3=BCst:=20Jekyll-Build=20im=20Contai?= =?UTF-8?q?ner,=20Pr=C3=BCfskript=20und=20CI-Workflow?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Baut ohne lokale Ruby-Installation über ruby:3.3, mit demselben Gemfile.lock wie der CI-Runner. Das Prüfskript tritt an die Stelle einer Testsuite und wächst mit jeder weiteren Aufgabe. Die sechs Altseiten stehen vorerst in exclude: Sie gehören nicht mehr zur Ausgabe und würden später die Weiterleitungsstümpfe gleichen Namens verdecken. Gelöscht werden sie in Aufgabe 9. Co-Authored-By: Claude Opus 5 --- .github/workflows/pages.yml | 49 + .gitignore | 4 + Gemfile | 8 + Gemfile.lock | 170 ++ _config.yml | 48 + _layouts/basis.html | 14 + .../2026-09-12-webseite-modernisierung.md | 2351 +++++++++++++++++ ...26-09-12-webseite-modernisierung-design.md | 404 +++ index.html | 70 +- werkzeug/bauen.ps1 | 29 + werkzeug/pruefe_ausgabe.py | 85 + 11 files changed, 3167 insertions(+), 65 deletions(-) create mode 100644 .github/workflows/pages.yml create mode 100644 .gitignore create mode 100644 Gemfile create mode 100644 Gemfile.lock create mode 100644 _config.yml create mode 100644 _layouts/basis.html create mode 100644 docs/superpowers/plans/2026-09-12-webseite-modernisierung.md create mode 100644 docs/superpowers/specs/2026-09-12-webseite-modernisierung-design.md create mode 100644 werkzeug/bauen.ps1 create mode 100644 werkzeug/pruefe_ausgabe.py diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml new file mode 100644 index 0000000..154c220 --- /dev/null +++ b/.github/workflows/pages.yml @@ -0,0 +1,49 @@ +name: Seite bauen und veröffentlichen + +on: + push: + branches: [main] + pull_request: + workflow_dispatch: + +permissions: + contents: read + pages: write + id-token: write + +concurrency: + group: pages + cancel-in-progress: false + +jobs: + bauen: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - uses: ruby/setup-ruby@v1 + with: + ruby-version: "3.3" + bundler-cache: true + - uses: actions/setup-python@v5 + with: + python-version: "3.11" + - name: Seite bauen + run: bundle exec jekyll build + env: + JEKYLL_ENV: production + - name: Ausgabe prüfen + run: python werkzeug/pruefe_ausgabe.py + - uses: actions/upload-pages-artifact@v3 + with: + path: _site + + veroeffentlichen: + needs: bauen + if: github.ref == 'refs/heads/main' + runs-on: ubuntu-latest + environment: + name: github-pages + url: ${{ steps.deploy.outputs.page_url }} + steps: + - id: deploy + uses: actions/deploy-pages@v4 diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..6a82177 --- /dev/null +++ b/.gitignore @@ -0,0 +1,4 @@ +_site/ +.jekyll-cache/ +.jekyll-metadata +rohbilder/ diff --git a/Gemfile b/Gemfile new file mode 100644 index 0000000..b3a17cc --- /dev/null +++ b/Gemfile @@ -0,0 +1,8 @@ +source "https://rubygems.org" + +gem "jekyll", "~> 4.3.4" +gem "jekyll-feed", "~> 0.17" +gem "jekyll-seo-tag", "~> 2.8" +gem "jekyll-sitemap", "~> 1.4" +gem "jekyll-redirect-from", "~> 0.16" +gem "webrick", "~> 1.8" diff --git a/Gemfile.lock b/Gemfile.lock new file mode 100644 index 0000000..9de51c9 --- /dev/null +++ b/Gemfile.lock @@ -0,0 +1,170 @@ +GEM + remote: https://rubygems.org/ + specs: + addressable (2.9.0) + public_suffix (>= 2.0.2, < 8.0) + bigdecimal (4.1.2) + colorator (1.1.0) + concurrent-ruby (1.3.8) + em-websocket (0.5.3) + eventmachine (>= 0.12.9) + http_parser.rb (~> 0) + eventmachine (1.2.7) + ffi (1.17.4) + ffi (1.17.4-aarch64-linux-gnu) + ffi (1.17.4-aarch64-linux-musl) + ffi (1.17.4-arm-linux-gnu) + ffi (1.17.4-arm-linux-musl) + ffi (1.17.4-arm64-darwin) + ffi (1.17.4-x86-linux-gnu) + ffi (1.17.4-x86-linux-musl) + ffi (1.17.4-x86_64-darwin) + ffi (1.17.4-x86_64-linux-gnu) + ffi (1.17.4-x86_64-linux-musl) + forwardable-extended (2.6.0) + google-protobuf (4.36.1) + bigdecimal + rake (~> 13.3) + google-protobuf (4.36.1-aarch64-linux-gnu) + bigdecimal + rake (~> 13.3) + google-protobuf (4.36.1-aarch64-linux-musl) + bigdecimal + rake (~> 13.3) + google-protobuf (4.36.1-arm64-darwin) + bigdecimal + rake (~> 13.3) + google-protobuf (4.36.1-x86-linux-gnu) + bigdecimal + rake (~> 13.3) + google-protobuf (4.36.1-x86-linux-musl) + bigdecimal + rake (~> 13.3) + google-protobuf (4.36.1-x86_64-darwin) + bigdecimal + rake (~> 13.3) + google-protobuf (4.36.1-x86_64-linux-gnu) + bigdecimal + rake (~> 13.3) + google-protobuf (4.36.1-x86_64-linux-musl) + bigdecimal + rake (~> 13.3) + http_parser.rb (0.8.1) + i18n (1.15.2) + concurrent-ruby (~> 1.0) + jekyll (4.3.4) + addressable (~> 2.4) + colorator (~> 1.0) + em-websocket (~> 0.5) + i18n (~> 1.0) + jekyll-sass-converter (>= 2.0, < 4.0) + jekyll-watch (~> 2.0) + kramdown (~> 2.3, >= 2.3.1) + kramdown-parser-gfm (~> 1.0) + liquid (~> 4.0) + mercenary (>= 0.3.6, < 0.5) + pathutil (~> 0.9) + rouge (>= 3.0, < 5.0) + safe_yaml (~> 1.0) + terminal-table (>= 1.8, < 4.0) + webrick (~> 1.7) + jekyll-feed (0.17.0) + jekyll (>= 3.7, < 5.0) + jekyll-redirect-from (0.16.0) + jekyll (>= 3.3, < 5.0) + jekyll-sass-converter (3.1.0) + sass-embedded (~> 1.75) + jekyll-seo-tag (2.9.0) + jekyll (>= 3.8, < 5.0) + jekyll-sitemap (1.4.0) + jekyll (>= 3.7, < 5.0) + jekyll-watch (2.2.1) + listen (~> 3.0) + kramdown (2.5.2) + rexml (>= 3.4.4) + kramdown-parser-gfm (1.1.0) + kramdown (~> 2.0) + liquid (4.0.4) + listen (3.10.0) + logger + rb-fsevent (~> 0.10, >= 0.10.3) + rb-inotify (~> 0.9, >= 0.9.10) + logger (1.7.0) + mercenary (0.4.0) + pathutil (0.16.2) + forwardable-extended (~> 2.6) + public_suffix (7.0.5) + rake (13.4.2) + rb-fsevent (0.11.2) + rb-inotify (0.11.1) + ffi (~> 1.0) + rexml (3.4.4) + rouge (4.7.0) + safe_yaml (1.0.5) + sass-embedded (1.104.0) + google-protobuf (~> 4.31) + rake (>= 13) + sass-embedded (1.104.0-aarch64-linux-android) + google-protobuf (~> 4.31) + sass-embedded (1.104.0-aarch64-linux-gnu) + google-protobuf (~> 4.31) + sass-embedded (1.104.0-aarch64-linux-musl) + google-protobuf (~> 4.31) + sass-embedded (1.104.0-arm-linux-androideabi) + google-protobuf (~> 4.31) + sass-embedded (1.104.0-arm-linux-gnueabihf) + google-protobuf (~> 4.31) + sass-embedded (1.104.0-arm-linux-musleabihf) + google-protobuf (~> 4.31) + sass-embedded (1.104.0-arm64-darwin) + google-protobuf (~> 4.31) + sass-embedded (1.104.0-riscv64-linux-android) + google-protobuf (~> 4.31) + sass-embedded (1.104.0-riscv64-linux-gnu) + google-protobuf (~> 4.31) + sass-embedded (1.104.0-riscv64-linux-musl) + google-protobuf (~> 4.31) + sass-embedded (1.104.0-x86_64-darwin) + google-protobuf (~> 4.31) + sass-embedded (1.104.0-x86_64-linux-android) + google-protobuf (~> 4.31) + sass-embedded (1.104.0-x86_64-linux-gnu) + google-protobuf (~> 4.31) + sass-embedded (1.104.0-x86_64-linux-musl) + google-protobuf (~> 4.31) + terminal-table (3.0.2) + unicode-display_width (>= 1.1.1, < 3) + unicode-display_width (2.6.0) + webrick (1.9.2) + +PLATFORMS + aarch64-linux-android + aarch64-linux-gnu + aarch64-linux-musl + arm-linux-androideabi + arm-linux-gnu + arm-linux-gnueabihf + arm-linux-musl + arm-linux-musleabihf + arm64-darwin + riscv64-linux-android + riscv64-linux-gnu + riscv64-linux-musl + ruby + x86-linux-gnu + x86-linux-musl + x86_64-darwin + x86_64-linux-android + x86_64-linux-gnu + x86_64-linux-musl + +DEPENDENCIES + jekyll (~> 4.3.4) + jekyll-feed (~> 0.17) + jekyll-redirect-from (~> 0.16) + jekyll-seo-tag (~> 2.8) + jekyll-sitemap (~> 1.4) + webrick (~> 1.8) + +BUNDLED WITH + 2.5.22 diff --git a/_config.yml b/_config.yml new file mode 100644 index 0000000..c371822 --- /dev/null +++ b/_config.yml @@ -0,0 +1,48 @@ +title: Conspiratio +description: >- + Conspiratio ist eine freie Wirtschaftssimulation der frühen Neuzeit: Handel, Ämter, + Intrigen und eine Dynastie, die den eigenen Tod überdauern muss. +url: https://conspiratio.net +lang: de + +plugins: + - jekyll-feed + - jekyll-seo-tag + - jekyll-sitemap + - jekyll-redirect-from + +permalink: /news/:year/:month/:day/:title/ + +defaults: + - scope: { path: "", type: posts } + values: { layout: news } + - scope: { path: "" } + values: { layout: seite } + +feed: + path: feed.xml + posts_limit: 50 # Vorgabe waere 10; der Feed soll das ganze Archiv tragen + +exclude: + - Gemfile + - Gemfile.lock + - README.md + - LICENSE + - docs/ + - werkzeug/ + - massenmails/ + - rohbilder/ + - "*.txt" + + # Die alte Seite. Sie bleibt bis Aufgabe 9 im Repo liegen, gehoert aber nicht + # mehr zur Ausgabe - und wuerde die Weiterleitungsstuempfe gleichen Namens + # verdecken, die jekyll-redirect-from erzeugt. + - geschichte.html + - download.html + - bilder.html + - ueber.html + - links.html + - kontakt.html + - cons.css + - OLDENGL.TTF + - Jurist_aufsuchen.png diff --git a/_layouts/basis.html b/_layouts/basis.html new file mode 100644 index 0000000..2534671 --- /dev/null +++ b/_layouts/basis.html @@ -0,0 +1,14 @@ + + + + + + {%- seo -%} + + + +
+ {{ content }} +
+ + diff --git a/docs/superpowers/plans/2026-09-12-webseite-modernisierung.md b/docs/superpowers/plans/2026-09-12-webseite-modernisierung.md new file mode 100644 index 0000000..398ee0f --- /dev/null +++ b/docs/superpowers/plans/2026-09-12-webseite-modernisierung.md @@ -0,0 +1,2351 @@ +# Modernisierung conspiratio.net — Implementierungsplan + +> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. + +**Goal:** Die Projektseite conspiratio.net wird eine responsive, umschaltbar helle/dunkle +Jekyll-Seite auf GitHub Pages, deren Newsmeldungen aus je einer Markdown-Datei entstehen. + +**Architecture:** Jekyll baut statisches HTML aus Layouts (`_layouts/`), Bausteinen (`_includes/`), +Daten (`_data/*.yml`) und Meldungen (`_posts/*.md`). Gebaut wird lokal in einem Docker-Container mit +derselben `Gemfile.lock` wie in CI; ausgeliefert wird über einen GitHub-Actions-Workflow. Die +Abnahme läuft über ein Python-Prüfskript, das die gebaute Seite in `_site/` gegen feste Zusagen +prüft — es ersetzt die Testsuite, die es für eine statische Seite sonst nicht gäbe. + +**Tech Stack:** Jekyll 4.3 (Ruby 3.3, im Container), jekyll-feed / -seo-tag / -sitemap / +-redirect-from, handgeschriebenes CSS mit Custom Properties, ~40 Zeilen Vanilla-JavaScript, +Python 3.11 (Prüfskript, Bildaufbereitung mit Pillow), GitHub Actions, lychee. + +**Spec:** [`docs/superpowers/specs/2026-09-12-webseite-modernisierung-design.md`](../specs/2026-09-12-webseite-modernisierung-design.md) + +## Global Constraints + +Diese Vorgaben gelten für **jede** Aufgabe; sie werden nicht je Aufgabe wiederholt. + +- **Repo:** `Conspiratio/conspiratio.github.io`, Arbeitszweig `feature/pages-neubau`, Zielzweig `main`. +- **Sprache:** Alle sichtbaren Texte, Dateinamen eigener Dateien, Commit-Nachrichten und Kommentare + auf **Deutsch**. Ausgenommen sind Schnittstellenbegriffe des Frameworks (`_posts`, `_data`, + `_layouts`, `title`, `date`, `excerpt`, `permalink`, `redirect_from`) — sie bleiben englisch, weil + Jekyll sie so und nur so liest. +- **Kein CMS, keine Datenbank, kein CSS- oder JS-Framework.** Genau eine CSS-Datei + (`assets/css/conspiratio.css`) und eine JS-Datei (`assets/js/einstellungen.js`). +- **Plugins abschließend:** `jekyll-feed`, `jekyll-seo-tag`, `jekyll-sitemap`, + `jekyll-redirect-from`. Keine weiteren. +- **Schriften werden selbst ausgeliefert.** Im gesamten `_site/` darf kein Verweis auf + `fonts.googleapis.com` oder `fonts.gstatic.com` stehen. +- **`OLDENGL.TTF` wird entfernt** (Microsoft-Systemschrift, nicht zur Weitergabe lizenziert) und darf + in keiner Fassung wieder auftauchen. +- **Ohne JavaScript** muss jede Seite vollständig lesbar und bedienbar bleiben; JavaScript schaltet + ausschließlich Thema und Schriftart um. +- **Kontrast** mindestens 4,5:1 in beiden Themen; jedes `` trägt `alt`, `width`, `height` und + `loading="lazy"` (Ausnahme: das Aufmacherbild der Startseite, das ohne `loading="lazy"` lädt). +- **Domain-Umschaltung findet in diesem Plan nicht statt.** Bis Aufgabe 10 liegt die neue Seite unter + `https://conspiratio.github.io`; `conspiratio.net` zeigt weiterhin auf Hostgator. Die DNS-Schritte + sind in Aufgabe 10 nur dokumentiert, nicht ausgeführt — sie kann nur der Domaineigentümer tun. +- **Jede Aufgabe endet grün:** `pwsh werkzeug/bauen.ps1` baut ohne Fehler **und** + `python werkzeug/pruefe_ausgabe.py` meldet keinen Fehler. Erst dann wird committet. + +### Werkzeugvoraussetzungen (einmalig, vor Aufgabe 1) + +Auf der Maschine vorhanden und geprüft: Docker 29.6, Python 3.11.4, Node 22, `gh` 2.96. +**Ruby ist nicht installiert und wird auch nicht installiert** — der Build läuft im Container. + +```powershell +python -m pip install --user pillow fonttools brotli +``` + +--- + +## Dateiübersicht + +Was am Ende im Repo steht und wofür jede Datei zuständig ist. Die Zuständigkeiten sind bewusst eng +geschnitten: ein Layout kennt nur seine Seitenform, ein Include nur seinen Baustein. + +| Datei | Zuständigkeit | Aufgabe | +|---|---|---| +| `Gemfile`, `Gemfile.lock` | Jekyll-Version und Plugins, exakt gepinnt | 1 | +| `_config.yml` | Titel, URL, Plugins, Permalinks, Standard-Layouts, `exclude` | 1 | +| `werkzeug/bauen.ps1` | Build und Vorschau im Docker-Container | 1 | +| `werkzeug/pruefe_ausgabe.py` | prüft `_site/` gegen feste Zusagen; wächst mit jeder Aufgabe | 1–10 | +| `.github/workflows/pages.yml` | Build bei PR, Build + Deploy auf `main` | 1, 10 | +| `_layouts/basis.html` | ``, ``, Themenattribut, Kopf, Fuß — sonst nichts | 2 | +| `_layouts/seite.html` | Inhaltsseite: Titel + Inhalt in der Textspalte | 2 | +| `_layouts/start.html` | Startseite: Aufmacher, Download-Knopf, News-Anrisse | 6 | +| `_layouts/news.html` | eine Meldung: Titel, Datum, Inhalt, Rückweg ins Archiv | 4 | +| `_includes/navigation.html` | Kopfnavigation aus `_data/navigation.yml`, aktiver Punkt markiert | 2 | +| `_includes/fuss.html` | Fußzeile inkl. Jahreszahl aus `site.time` | 2 | +| `_includes/schalter.html` | die drei Schalter (Thema, Schrift, EN) | 3 | +| `_includes/news-anriss.html` | ein Anriss; von Startseite und Archiv benutzt | 4 | +| `_data/navigation.yml` | Menüpunkte (Titel, Ziel, extern ja/nein) | 2 | +| `_data/downloads.yml` | je Release: Version, Datum, Größe, MSI-Link, Changelog-Link | 7 | +| `_data/team.yml`, `_data/links.yml` | Team- und Linkliste | 6 | +| `_data/bilder.yml` | Galerie: Datei, Alternativtext, Client, Maße | 8 | +| `assets/css/conspiratio.css` | gesamtes Aussehen; Custom Properties als einzige Schaltstelle | 3 | +| `assets/js/einstellungen.js` | Thema- und Schriftumschalter, `localStorage` | 3 | +| `assets/schriften/*.woff2` | Grenze Gotisch, EB Garamond, Atkinson Hyperlegible | 3 | +| `_posts/*.md` | je eine Newsmeldung | 4, 5 | +| `index.html`, `spiel.md`, `bilder.md`, `downloads.md`, `mitmachen.md`, `kontakt.md`, `links.md`, `impressum.md`, `en/index.md`, `news/index.html` | die Seiten | 6–8 | +| `CNAME` | `conspiratio.net` | 10 | +| `werkzeug/neue-news.ps1` | legt eine Meldungsdatei mit fertigem Kopf an | 4 | +| `werkzeug/bilder_aufbereiten.py` | Skalierung, WebP, Maße in `_data/bilder.yml` | 8 | + +--- + +## Aufgabe 1: Gerüst, Build im Container und Prüfskript + +Ohne diese Aufgabe kann keine andere abgenommen werden — sie liefert den Test-Kreislauf. + +**Files:** +- Create: `Gemfile`, `_config.yml`, `index.html`, `_layouts/basis.html` +- Create: `werkzeug/bauen.ps1`, `werkzeug/pruefe_ausgabe.py` +- Create: `.github/workflows/pages.yml`, `.gitignore` + +**Interfaces:** +- Consumes: nichts. +- Produces: + - `pwsh werkzeug/bauen.ps1` → baut nach `_site/`; `-Vorschau` startet den Server auf + `http://localhost:4000`. + - `python werkzeug/pruefe_ausgabe.py` → Exit 0 bei Erfolg, Exit 1 mit einer Fehlerliste sonst. + - `werkzeug/pruefe_ausgabe.py` stellt den folgenden Aufbau bereit, den **alle späteren Aufgaben + erweitern**: eine Funktion `pruefe(bedingung: bool, meldung: str) -> None`, eine Liste + `PRUEFUNGEN: list[Callable[[], None]]`, und `SITE: pathlib.Path` als Wurzel der gebauten Seite. + - Layout `basis` mit den Blöcken `{{ content }}`, `{{ page.title }}`. + +- [ ] **Step 1: Arbeitszweig anlegen** + +```bash +cd "D:/Projekte/C# Projekte/conspiratio.github.io" +git checkout -b feature/pages-neubau +``` + +- [ ] **Step 2: Das Prüfskript schreiben — es schlägt zuerst fehl** + +`werkzeug/pruefe_ausgabe.py`: + +```python +#!/usr/bin/env python3 +"""Prueft die gebaute Seite in _site/ gegen feste Zusagen. + +Aufruf: python werkzeug/pruefe_ausgabe.py +Exit 0 = alles in Ordnung, Exit 1 = mindestens eine Zusage verletzt. +""" +from __future__ import annotations + +import pathlib +import sys +from typing import Callable + +WURZEL = pathlib.Path(__file__).resolve().parent.parent +SITE = WURZEL / "_site" + +_fehler: list[str] = [] +PRUEFUNGEN: list[Callable[[], None]] = [] + + +def pruefe(bedingung: bool, meldung: str) -> None: + """Vermerkt einen Fehler, wenn die Bedingung nicht gilt.""" + if not bedingung: + _fehler.append(meldung) + + +def lies(pfad: str) -> str: + """Liest eine Datei aus _site/ als Text; leerer String, wenn sie fehlt.""" + datei = SITE / pfad + return datei.read_text(encoding="utf-8") if datei.is_file() else "" + + +def seiten() -> list[pathlib.Path]: + """Alle gebauten HTML-Dateien.""" + return sorted(SITE.rglob("*.html")) + + +def ist_weiterleitung(text: str) -> bool: + """Von jekyll-redirect-from erzeugte Stuempel sind keine richtigen Seiten: + sie tragen weder Navigation noch Fuss und stehen auf lang="en-US".""" + return 'http-equiv="refresh"' in text + + +def pruefung(funktion: Callable[[], None]) -> Callable[[], None]: + PRUEFUNGEN.append(funktion) + return funktion + + +@pruefung +def die_seite_wurde_gebaut() -> None: + pruefe(SITE.is_dir(), "_site/ fehlt - wurde `pwsh werkzeug/bauen.ps1` ausgefuehrt?") + pruefe((SITE / "index.html").is_file(), "_site/index.html fehlt") + + +@pruefung +def jede_seite_nennt_ihre_sprache() -> None: + for seite in seiten(): + text = seite.read_text(encoding="utf-8") + if ist_weiterleitung(text): + continue + pfad = seite.relative_to(SITE) + erwartet = 'lang="en"' if str(pfad).startswith("en") else 'lang="de"' + pruefe(erwartet in text, f"{pfad}: erwartet {erwartet} im -Tag") + + +def main() -> int: + for funktion in PRUEFUNGEN: + funktion() + if _fehler: + print(f"{len(_fehler)} Zusage(n) verletzt:\n") + for meldung in _fehler: + print(f" - {meldung}") + return 1 + print(f"{len(PRUEFUNGEN)} Pruefung(en) bestanden.") + return 0 + + +if __name__ == "__main__": + sys.exit(main()) +``` + +- [ ] **Step 3: Prüfskript laufen lassen — es muss fehlschlagen** + +Run: `python werkzeug/pruefe_ausgabe.py` +Expected: Exit 1, „`_site/ fehlt`" und „`_site/index.html fehlt`". + +- [ ] **Step 4: Gemfile, Konfiguration und ein Minimallayout schreiben** + +`Gemfile`: + +```ruby +source "https://rubygems.org" + +gem "jekyll", "~> 4.3.4" +gem "jekyll-feed", "~> 0.17" +gem "jekyll-seo-tag", "~> 2.8" +gem "jekyll-sitemap", "~> 1.4" +gem "jekyll-redirect-from", "~> 0.16" +gem "webrick", "~> 1.8" +``` + +`_config.yml`: + +```yaml +title: Conspiratio +description: >- + Conspiratio ist eine freie Wirtschaftssimulation der frühen Neuzeit: Handel, Ämter, + Intrigen und eine Dynastie, die den eigenen Tod überdauern muss. +url: https://conspiratio.net +lang: de + +plugins: + - jekyll-feed + - jekyll-seo-tag + - jekyll-sitemap + - jekyll-redirect-from + +permalink: /news/:year/:month/:day/:title/ + +defaults: + - scope: { path: "", type: posts } + values: { layout: news } + - scope: { path: "" } + values: { layout: seite } + +feed: + path: feed.xml + posts_limit: 50 # Vorgabe waere 10; der Feed soll das ganze Archiv tragen + +exclude: + - Gemfile + - Gemfile.lock + - README.md + - LICENSE + - docs/ + - werkzeug/ + - massenmails/ + - rohbilder/ + - "*.txt" +``` + +`_layouts/basis.html` (vorläufig; Kopf und Fuß kommen in Aufgabe 2): + +```html + + + + + + {%- seo -%} + + + +
+ {{ content }} +
+ + +``` + +`index.html`: + +```html +--- +layout: basis +title: Conspiratio +--- +

Conspiratio

+``` + +`.gitignore`: + +``` +_site/ +.jekyll-cache/ +.jekyll-metadata +rohbilder/ +``` + +- [ ] **Step 5: Das Bauskript schreiben** + +`werkzeug/bauen.ps1`: + +```powershell +<# +.SYNOPSIS + Baut die Seite im Docker-Container - ohne lokale Ruby-Installation. +.DESCRIPTION + Benutzt dasselbe Gemfile.lock wie CI, weil der Container Linux ist wie der Runner. + Die Gems liegen in einem benannten Volume und ueberleben den Lauf. +.PARAMETER Vorschau + Startet statt eines einmaligen Builds den Entwicklungsserver auf http://localhost:4000. +#> +param([switch]$Vorschau) + +$ErrorActionPreference = "Stop" +$wurzel = Split-Path $PSScriptRoot -Parent + +# --force_polling: Dateiaenderungen auf einem Windows-Bind-Mount erreichen den +# Container nicht als Ereignis, nur durch Nachsehen. +$befehl = if ($Vorschau) { + "bundle install --quiet && bundle exec jekyll serve --host 0.0.0.0 --force_polling" +} else { + "bundle install --quiet && bundle exec jekyll build" +} + +docker run --rm ` + -v "${wurzel}:/srv" -w /srv ` + -v conspiratio-gems:/usr/local/bundle ` + -p 4000:4000 ` + ruby:3.3 bash -lc $befehl + +if ($LASTEXITCODE -ne 0) { throw "Build fehlgeschlagen (Exit $LASTEXITCODE)" } +``` + +- [ ] **Step 6: Bauen und prüfen — jetzt muss es grün sein** + +```powershell +pwsh werkzeug/bauen.ps1 +python werkzeug/pruefe_ausgabe.py +``` + +Expected: Build ohne Fehler, `_site/index.html` vorhanden, „2 Pruefung(en) bestanden." +Der erste Lauf dauert wegen `bundle install` mehrere Minuten; danach ist das Volume gefüllt. + +- [ ] **Step 7: Den CI-Workflow schreiben** + +`.github/workflows/pages.yml`: + +```yaml +name: Seite bauen und veröffentlichen + +on: + push: + branches: [main] + pull_request: + workflow_dispatch: + +permissions: + contents: read + pages: write + id-token: write + +concurrency: + group: pages + cancel-in-progress: false + +jobs: + bauen: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - uses: ruby/setup-ruby@v1 + with: + ruby-version: "3.3" + bundler-cache: true + - uses: actions/setup-python@v5 + with: + python-version: "3.11" + - name: Seite bauen + run: bundle exec jekyll build + env: + JEKYLL_ENV: production + - name: Ausgabe prüfen + run: python werkzeug/pruefe_ausgabe.py + - uses: actions/upload-pages-artifact@v3 + with: + path: _site + + veroeffentlichen: + needs: bauen + if: github.ref == 'refs/heads/main' + runs-on: ubuntu-latest + environment: + name: github-pages + url: ${{ steps.deploy.outputs.page_url }} + steps: + - id: deploy + uses: actions/deploy-pages@v4 +``` + +- [ ] **Step 8: `Gemfile.lock` aus dem Container übernehmen und committen** + +Der Container hat die Datei beim ersten `bundle install` geschrieben. Sie **muss** eingecheckt +werden, sonst ist die Version in CI nicht gepinnt und `bundler-cache: true` greift nicht. + +```bash +git add Gemfile Gemfile.lock _config.yml index.html _layouts/basis.html .gitignore \ + werkzeug/bauen.ps1 werkzeug/pruefe_ausgabe.py .github/workflows/pages.yml +git status # Gemfile.lock muss dabei sein +git commit -F - <<'EOF' +Gerüst: Jekyll-Build im Container, Prüfskript und CI-Workflow + +Baut ohne lokale Ruby-Installation über ruby:3.3, mit demselben +Gemfile.lock wie der CI-Runner. Das Prüfskript tritt an die Stelle +einer Testsuite und wächst mit jeder weiteren Aufgabe. + +Co-Authored-By: Claude Opus 5 +EOF +``` + +--- + +## Aufgabe 2: Basislayout, Navigation und Fußzeile + +Beseitigt die Ursache des wiederkehrenden Ärgers („Jahreszahl auf jeder Seite aktualisiert"): +Navigation und Fußzeile stehen ab hier **einmal** im Repo. + +**Files:** +- Create: `_data/navigation.yml`, `_includes/navigation.html`, `_includes/fuss.html`, + `_layouts/seite.html` +- Modify: `_layouts/basis.html`, `werkzeug/pruefe_ausgabe.py` +- Create: `spiel.md` (als zweite Seite, damit die Navigation prüfbar wird) + +**Interfaces:** +- Consumes: `pruefe`, `lies`, `seiten`, `pruefung`, `SITE` aus Aufgabe 1. +- Produces: + - `_data/navigation.yml`: Liste von Einträgen mit den Schlüsseln `titel`, `ziel`, `extern` + (bool, optional). + - Layout `seite` (erwartet `title` im Frontmatter). + - Jede gebaute Seite enthält `