Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
146 changes: 146 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,146 @@
# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Überblick

Die Projektseite von **Conspiratio** (<https://conspiratio.net>), einem freien Wirtschaftssimulations-
spiel der frühen Neuzeit. Eine statische Jekyll-Seite, die über GitHub Actions nach GitHub Pages
veröffentlicht wird. Kein CMS, kein CSS- oder JS-Framework: genau **eine** CSS-Datei
(`assets/css/conspiratio.css`) und **eine** JS-Datei (`assets/js/einstellungen.js`, nur die beiden
Umschalter). Die ganze Seite wiegt rund 1,3 MB.

Alle sichtbaren Texte, eigenen Dateinamen, Kommentare und Commit-Nachrichten sind **deutsch**.
Ausgenommen sind Schnittstellenbegriffe des Frameworks (`_posts`, `_data`, `_layouts`, `title`,
`date`, `excerpt`, `permalink`, `redirect_from`) — Jekyll liest sie so und nur so.

**Angeredet wird mit „Ihr", nicht mit „Sie"** — durchgehend, auch auf Datenschutz- und
Downloadseite. Das entspricht dem Ton des Spiels.

**Keine Zahl ohne Beleg.** Auf der Mitmachen-Seite stand einmal, die Grafiken seien „zwanzig Jahre
alt" — frei erfunden, weil es plausibel klang. Belegen ließ sich nichts: Die Bilddateien tragen
keine Zeitangaben, dieses Repo reicht bis 2022 zurück, das WinForms-Repo bis 2020, und der früheste
Fund im Internet Archive (`header4.png`, Oktober 2017) datiert nur die Webseite. Im Zweifel gar
keine Zahl.

Schwesterrepos: `Conspiratio.Godot` (der neue Client), `Conspiratio.WinForms` (der bisherige, dort
liegen die Releases), `Conspiratio.Wiki` (Spielerdokumentation).

## Bauen und prüfen

**Kein lokales Ruby nötig** — der Build läuft im Docker-Container mit derselben `Gemfile.lock` wie
der CI-Runner. Docker Desktop muss laufen.

```powershell
powershell -File werkzeug/bauen.ps1 # einmalig nach _site/
powershell -File werkzeug/bauen.ps1 -Vorschau # Server auf http://localhost:4000
python werkzeug/pruefe_ausgabe.py # prüft die gebaute Seite
```

Der Port wird nur bei `-Vorschau` veröffentlicht, damit ein Build neben einer laufenden Vorschau
nicht an „port is already allocated" scheitert.

### Das Prüfskript ist die Testsuite

`werkzeug/pruefe_ausgabe.py` tritt an die Stelle der Tests, die es für eine statische Seite sonst
nicht gäbe. Es prüft **die gebaute Ausgabe in `_site/`**, nicht die Quellen, und läuft auch in CI —
ein Fehler verhindert die Veröffentlichung. Derzeit 33 Zusagen, darunter: Sprache je Seite,
Navigation und Fußzeile, WCAG-Kontrast beider Themen (aus dem CSS gelesen, nicht dupliziert), tote
interne Verweise, Alternativtexte und Bildmaße, die Weiterleitungen der alten Adressen, die
Vollständigkeit des Newsarchivs, Titellänge, Platzhalter und englische Monatsnamen.

Eine neue Prüfung ist eine Funktion mit `@pruefung`-Dekorator; sie ruft `pruefe(bedingung, meldung)`
und nutzt die Helfer `lies()`, `seiten()`, `meldungen()`, `ist_weiterleitung()`.

**Zwei Regeln, die sich bewährt haben:**

- **Erst die Zusage schreiben, sie fehlschlagen sehen, dann erfüllen.** So ist geklärt, dass die
Prüfung überhaupt greifen kann.
- **Eine neue Prüfung einmal absichtlich brechen.** Mehrere Prüfungen sind so gegengeprüft worden
(Kontrast, interner Linkprüfer, `aria-label` der Schalter) — eine, die nicht fehlschlagen kann,
ist wertlos.
- Fehlermeldungen bleiben **ASCII**: Die Windows-Konsole zerlegt Umlaute, und man will den Lauf nach
einem Wort durchsuchen können.

## Wiederkehrende Aufgaben

| Aufgabe | Wie |
|---|---|
| Newsmeldung | **eine** Datei `_posts/JJJJ-MM-TT-kuerzel.md` mit `title` und `excerpt`. Geht auch über die Weboberfläche von GitHub, ohne lokales Repo. `werkzeug/neue-news.ps1 "Titel"` legt sie mit fertigem Kopf an. |
| Neues Release | ein Eintrag oben in `_data/downloads.yml`. Der oberste gilt als aktuelle Fassung, alle weiteren als Archiv. |
| Bilder | `python werkzeug/bilder_aufbereiten.py` — skaliert aus `quellen/` und `rohbilder/` nach `assets/bilder/` (WebP, 1000 px) und schreibt `_data/bilder.yml`. Die Alternativtexte stehen **im Skript**; ein Motiv ohne Alternativtext wird absichtlich nicht aufbereitet. |
| Schriften | `werkzeug/schriften_holen.ps1`, einmalig. Liegen als woff2 im Repo. |
| Navigation | `_data/navigation.yml` |

## Aufbau

`_layouts/basis.html` trägt Kopf, Zierbalken, Navigation, Schalter und Fuß; `seite`, `start` und
`news` bauen darauf auf. Inhalte, die sich wiederholen, stehen in `_data/*.yml` und werden in Liquid
durchlaufen — Navigation, Downloads, Team, Links, Bilder. Damit steht jede Angabe **einmal** im Repo;
die Jahreszahl im Fuß etwa kommt aus `site.time`.

**`quellen/` enthält das unbearbeitete Bildmaterial** und steht in der `exclude`-Liste von
`_config.yml`: Ausgeliefert werden nur die fertigen WebP unter `assets/bilder/`. `rohbilder/` ist
zusätzlich in `.gitignore` (große Aufnahmen aus dem E2E-Treiber des Godot-Clients).

### Gestaltung

Die Custom Properties auf `:root` sind die einzige Schaltstelle. Ein Thema wird an **drei** Stellen
gepflegt: `:root` (hell), die `prefers-color-scheme`-Abfrage und `:root[data-thema="dunkel"]` — die
letzten beiden identisch, damit sowohl die Systemeinstellung als auch die eigene Wahl greifen.
Dasselbe Muster beim Schriftschalter (`[data-schrift="lesbar"]`).

Ein Inline-Skript im `<head>` setzt `data-thema`/`data-schrift` aus `localStorage`, **bevor** der
Browser zeichnet; ohne das blitzt beim Laden das falsche Thema auf. `einstellungen.js` setzt danach
nur noch Attribute — **niemals `textContent`**, sonst verschwindet die SVG im Themenschalter. Welches
Symbol sichtbar ist, entscheidet das Stylesheet.

Ohne JavaScript muss jede Seite vollständig lesbar und bedienbar bleiben; JS schaltet ausschließlich
Thema und Schrift.

## Fallstricke, die in diesem Repo schon zugeschlagen haben

- **PowerShell-Here-Strings taugen nicht für `git commit -F -`.** Der Text landet als Argument statt
auf stdin. Für Commit-Nachrichten den Bash-Heredoc nehmen: `git commit -F - <<'EOF' … EOF`.
- **Python-Skripte in eine Datei schreiben, nicht als Heredoc einspeisen.** Über den Heredoc kommen
Umlaute zerlegt an; ein Anker mit „Änderung" trifft dann nie.
- **Zeilenenden messen, nie annehmen.** Der Arbeitsbaum ist gemischt (git wandelt beim Auschecken
um). Mit `newline=""` lesen, das dominante Ende bestimmen und die Anker darauf umstellen — sonst
trifft ein mit `\n` geschriebener Anker eine CRLF-Datei nie. Danach `git diff --stat` prüfen: Ein
Diff über die ganze Datei heißt, die Zeilenenden sind umgekippt.
- **Vor jedem `replace` ein `assert alt in s`.** Hat hier mehrfach verhindert, dass eine Datei halb
umgeschrieben wird.
- **`git add -A` ist durch einen Hook blockiert.** Geänderte Pfade einzeln stagen.
- **GitHub Pages kann keine HTTP-Weiterleitung.** Kein `.htaccess`, keine `_redirects`, keine 301.
`jekyll-redirect-from` erzeugt HTML mit `<meta http-equiv="refresh">`. Gemessen: `.php`-Dateien
liefert Pages mit Status 200, aber als `application/x-httpd-php` aus — der Browser lädt sie
herunter. Weiterleitungsseiten unter alten `.php`-Pfaden scheiden damit aus; das fängt `404.html`
per JavaScript ab.
- **`main` ist geschützt** (eine Freigabe nötig). Einen eigenen PR kann man nicht selbst freigeben;
der Eigentümer steht auf der Ausnahmeliste, gemergt wird mit `gh pr merge <n> --merge --admin`.
- **Dateien über 100 MB weist GitHub beim Push ab.** Große Binärdateien gehören an ein Release, nicht
ins Repo (die MSI von 1.4.1/1.4.2 hängen am Tag `archiv-2018-2019` im WinForms-Repo).
- **Jekylls `date`-Filter schreibt Monatsnamen englisch.** Für ausgeschriebene Daten
`{% include datum-lang.html datum=… %}` benutzen; eine Prüfung schlägt sonst an.
- **`<details>` als Aufklappnavigation funktioniert nicht** wie erhofft: Ein geschlossenes `<details>`
verbirgt seine Kinder über einen Mechanismus des Browsers, den eine Media Query nicht verlässlich
aufhebt. Die Navigation war dadurch oberhalb von 700 px unsichtbar **und** nicht zu öffnen. Sie
bricht jetzt schlicht um.
- **Wartebedingungen eindeutig wählen.** Eine Schleife, die auf das Wort „umgezogen" wartete, brach
sofort ab — das Wort stand auch auf der 404-Seite.

## Veröffentlichung und Domain

`.github/workflows/pages.yml` baut bei jedem Pull Request und veröffentlicht zusätzlich auf `main`.
Der lychee-Schritt prüft externe Verweise **ohne fehlzuschlagen** (fremde Seiten verschwinden, ohne
dass die eigene Veröffentlichung daran scheitern soll); interne Verweise prüft `pruefe_ausgabe.py`,
und das schlägt sehr wohl fehl. lychee braucht `--root-dir`, sonst meldet es jeden wurzelrelativen
Pfad als Fehler.

Die Seite läuft unter `https://conspiratio.github.io/`. **Die Umstellung von `conspiratio.net` auf
Pages hat noch nicht stattgefunden** — Reihenfolge, DNS-Werte und Fallstricke stehen in
[`docs/umstellung-dns.md`](docs/umstellung-dns.md). Bis dahin melden CI-Läufe zwei Gruppen toter
Verweise, beide erwartet: `forum.conspiratio.net` (die Subdomain entsteht erst) und
`conspiratio.net/…` (kanonische Adressen, geprüft gegen die noch laufende alte Seite).

Entwurf und Plan des Neubaus liegen unter [`docs/superpowers/`](docs/superpowers/).
1 change: 1 addition & 0 deletions _config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ exclude:
- Gemfile
- Gemfile.lock
- README.md
- CLAUDE.md
- LICENSE
- docs/
- werkzeug/
Expand Down
7 changes: 7 additions & 0 deletions _data/navigation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,13 @@
ziel: /downloads/
- titel: News
ziel: /news/
# Das Forum steht schon jetzt auf der Subdomain. Solange der Apex noch auf den
# alten Webspeicher zeigt, ist sie nur dann erreichbar, wenn sie dort angelegt
# wurde - siehe docs/umstellung-dns.md, Schritt 1.
- titel: Forum
ziel: https://forum.conspiratio.net/
extern: true

# Das eigenstaendige Handbuch zum Godot-Client entsteht erst
# (https://conspiratio.github.io/Conspiratio.Wiki/ - derzeit 404). Bis dahin
# zeigt der Menuepunkt auf das vorhandene Wiki, wie die alte Seite auch.
Expand Down
26 changes: 21 additions & 5 deletions _posts/2018-12-24-conspiratio-1-4-1.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,25 @@
---
title: "Conspiratio 1.4.1 zu Weihnachten"
excerpt: "Das Weihnachtsupdate 2018."
title: "Frohe Weihnachten und Conspiratio 1.4.1"
date: 2018-12-24 17:39:59 +0000
excerpt: "Die Tradition des Updates an Heiligabend bleibt gewahrt - und für das kommende Jahr sind Änderungen am Projekt angekündigt."
---

Zum Weihnachtsfest 2018 ist Conspiratio 1.4.1 erschienen.
Liebe Spieler,

- [Conspiratio.1.4.1.0.msi](https://github.com/Conspiratio/Conspiratio.WinForms/releases/download/archiv-2018-2019/Conspiratio.1.4.1.0.msi) (217 MB)
- [Changelog](https://github.com/Conspiratio/Conspiratio.WinForms/blob/main/CHANGELOG.md#141---24122018)
wir wünschen euch allen ein frohes und angenehmes Weihnachtsfest. Um unsere kleine "Tradition" eines Updates an Heilig Abend nicht zu unterbrechen, dürfen wir euch hiermit die Version 1.4.1 ankündigen, welche ab sofort zum Download bereit steht:

[Downloadseite](/downloads/)

Die Version enthält einige (kleinere) Verbesserungen und Fehlerbehebungen und sollte euch hoffentlich ein noch flüssigeres Spielerlebnis ermöglichen. Den vollständigen Changelog findet ihr wie gewohnt hier:

[Forum](https://forum.conspiratio.net/viewtopic.php?f=11&t=44)

Wir freuen uns wie immer über euer Feedback im Forum:

[Forum](https://forum.conspiratio.net/viewtopic.php?f=12&t=45)

Im nächsten Jahr wird es zum Projekt von Conspiratio ein paar Änderungen geben, die wir noch bekannt geben werden. Ihr dürft gespannt sein ...

Bis dahin wünschen wir euch viel Spaß und einen guten Rutsch ins neue Jahr,

Euer Conspiratio Team
23 changes: 23 additions & 0 deletions _posts/2019-01-01-youtube-kanal.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
title: "Ein YouTube-Kanal für Anleitungsvideos"
date: 2019-01-01 13:20:09 +0000
excerpt: "Eine 50-minütige Einführung in vier Teilen soll das fehlende Handbuch ein wenig ausgleichen."
---

Hallo liebe Spieler,

ein frohes neues Jahr euch allen!

Ich darf mit Freude vermelden, dass ab heute einer kleiner Youtube Kanal zu Conspiratio online gegangen ist:

[YouTube-Kanal](https://www.youtube.com/channel/UCBNIo4SB2c2GkgL7f_dMN_w)

Geplant ist, dass hier Videos zu Conspiratio hochgeladen werden, die ein wenig das Spiel, die Steuerung und zukünftig vielleicht auch neue Features erklären. Erwartet aber bitte keine perfekten Videos, da wir/ich keine professionellen Youtube/Streamer/Cutter sind und auch kein entsprechendes Equipment besitzen und das noch alles neu für mich ist. Ihr findet auf dem Kanal bereits jetzt eine 50-minütige Einführung in 4 Teilen für neue Spieler, die ein wenig das derzeit fehlende Handbuch kompensieren soll.

Gerne kann sich jeder Interessierte am Aufbau des Kanals beteiligen und Anleitungsvideos, Let's Plays oder ähnliches beisteuern.

Zur Zeit arbeite ich ein wenig an einer Erweiterung der Website, weitere Neuigkeiten gibt es bald.

Gruß

Sir Toby
24 changes: 19 additions & 5 deletions _posts/2019-12-24-conspiratio-1-4-2.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,23 @@
---
title: "Conspiratio 1.4.2 zu Weihnachten"
excerpt: "Das Weihnachtsupdate 2019."
title: "Fröhliche Weihnachten und Conspiratio 1.4.2"
date: 2019-12-24 16:03:32 +0000
excerpt: "Ein kleineres Update - und der Changelog zieht zu GitHub um."
---

Zum Weihnachtsfest 2019 ist Conspiratio 1.4.2 erschienen.
Liebe Spieler,

- [Conspiratio.1.4.2.0.msi](https://github.com/Conspiratio/Conspiratio.WinForms/releases/download/archiv-2018-2019/Conspiratio.1.4.2.0.msi) (217 MB)
- [Changelog](https://github.com/Conspiratio/Conspiratio.WinForms/blob/main/CHANGELOG.md#142---24122019)
ein fröhliches Weihnachtsfest euch allen! Es ist mal wieder so weit, der Heiligabend ist da und das heißt, es steht eine neue Version von Conspiratio zum Download bereit:

Download: [Conspiratio 1.4.2](https://github.com/Conspiratio/Conspiratio.WinForms/releases/download/archiv-2018-2019/Conspiratio.1.4.2.0.msi)

Leider haben wir dieses Jahr nicht so viel Zeit gefunden, wie wir gerne gehabt hätten, um sie in das Projekt Conspiratio zu stecken. Daher enthält das Update nur kleinere Neuerungen aber auch einige Verbesserungen und Korrekturen. Den vollständigen Changelog findet ihr ab jetzt an dieser Stelle:

[GitHub Changelog](https://github.com/Conspiratio/Conspiratio.WinForms/blob/main/CHANGELOG.md#142---24122019)

Warum auf GitHub, fragt ihr euch? Wir werden Conspiratio zu einem Open Source Projekt machen, näheres dazu findet ihr in [diesem gesonderten Newsbeitrag](https://forum.conspiratio.net/viewtopic.php?f=32&t=51) im Forum.

Wir freuen uns wie immer über euer [Feedback im Forum](https://forum.conspiratio.net/viewtopic.php?f=12&t=50).

Wir wünschen euch viel Spaß und einen guten Rutsch ins neue Jahr,

Euer Conspiratio Team
25 changes: 25 additions & 0 deletions _posts/2019-12-24-die-zukunft-von-conspiratio.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
title: "Die Zukunft von Conspiratio"
date: 2019-12-24 15:57:48 +0000
excerpt: "Neue Projektleitung, ein geplanter neuer Client auf einer echten Spiele-Engine - und der Schritt zu Open Source."
---

Werte Spieler,

große Ereignisse werfen ihre Schatten voraus ... nun ja, zumindest fast.

Es gibt mehrere Veränderungen und Neuerungen im Projekt Conspiratio, die wir gerne mit euch teilen möchten.

Zunächst verkünden wir, dass die aktuelle Projektleitung auf Tobias (Sir Toby) übergegangen ist. Marco (DerEinzehnte) beteiligt sich aus zeitlichen Gründen für einige Zeit nicht mehr aktiv an der Weiterentwicklung, bleibt aber nach wie vor im Hintergrund präsent. Die letzten Updates und größeren Erweiterungen sind unter der Federführung von Tobias entstanden, daher glauben wir, dass dies der richtige Schritt ist. Tobias selbst möchte ein wenig frischen Wind in das Projekt bringen und freut sich darauf, seine Ideen anbringen und umsetzen zu können, insbesondere durch eine stärkere Einbindung der Community.

Die zweite Neuerung betrifft das Spiel an sich. Da wir mit dem aktuellen Framework, welches für die Umsetzung des Spiels ursprünglich verwendet wurde (.NET Windows Forms) immer mehr an (technische) Grenzen stoßen, euch aber ein flüssiges Spielerlebnis mit voller Multimediaunterstützung und modernen Features bieten wollen, planen wir einen neuen Spielclient mit einer "richtigen" Spieleengine zu entwickeln. Damit wir möglichst viel von dem bestehenden Quellcode (C#) und der Gameplaylogik wiederverwenden können, haben wir uns für Unity entschieden. Diesen neuen Unity Client wollen wir außerdem als Open Source Projekt unter der GNU General Public License v3.0 auf der Plattform [Github](https://github.com/Conspiratio/) entwickeln, um Interessierten die Möglichkeit zu geben, an dem Projekt ohne große Hürden mitarbeiten zu können. Geplant ist nach wie vor eine 2D-Umsetzung ohne "echte" 3D-Grafik aber das ist natürlich nicht in Stein gemeißelt.

Für euch bedeutet dies, dass der aktuelle Spieleclient vorraussichtlich nicht mehr so stark wie bisher weiterentwickelt wird (außer für Bugfixes für von euch gemeldeten Fehlern), damit wir uns ganz auf das Thema Unity konzentrieren und uns hier einarbeiten können. Ihr könnt nun aber viel direkter am Entwicklungsprozess teilhaben, geplante Features einsehen und den Changelog auf Github verfolgen, schon bevor ein neues Update veröffentlicht wird. Vorher sind jedoch noch einiges an Grundlagenarbeit notwendig, um die alte Struktur und Gameplaylogik so auszubereiten, dass sie einfach von Unity verwendet werden kann (sog. Refactoring).

Da leider auch Andreas (beetle), unser Grafiker, aktuell wenig Zeit für das Projekt aufbringen kann, suchen wir hier nach Verstärkung des Teams im grafischen Bereich. Wenn du immer schon mal an einer Open Source Umsetzung der Neuauflage eines beliebten DOS-Spiel mitwirken wolltest und du Spaß an der Erstellung von (2D-)Spielegrafiken hast, dann melde dich doch bei uns. Das gleiche gilt natürlich auch für Programmierer, idealerweise schon mit Unity Erfahrung aber das ist keine Voraussetzung. Du kannst natürlich auch ganz unverbindlich über Forks und Pull Requests in Github mit an dem Projekt arbeiten.

Als weitere Neuerung wurde die Homepage inhaltlich entsprechend überarbeitet und erweitert. Zu erwähnen ist außerdem, dass wir einen kleinen [Youtube Kanal für Anleitungsvideos](https://www.youtube.com/channel/UCBNIo4SB2c2GkgL7f_dMN_w) ins Leben gerufen haben (Details [hier](https://forum.conspiratio.net/viewtopic.php?f=32&p=134#p134)). Damit auch neuen Spielern der Einstieg möglichst einfach gemacht wird, gibt es nun zusätzlich ein offizielles Conspiratio Wiki, welches in der nächsten Zeit ein Grundgerüst von uns erhält und dann nur darauf wartet, von euch mit Inhalt gefüllt zu werden.

Wir hoffen, dass ihr diese Entwicklung von Conspiratio genauso spannend findet wie wir und vielleicht fühlt sich der ein oder andere ja motiviert dazu, sich an unserer Vision zu beteiligen und mitzuhelfen.

Euer Conspiratio Team
Loading
Loading