Kritik_und_Verbesserungsvorschlaege in .gitignore - mit einer Ausnahme

Rezension und Verbesserungsvorschlaege haben ihren Zweck erfuellt und gehoeren
nicht in die Veroeffentlichung. Fuenf der sechs Dateien sind ausgetragen; sie
bleiben lokal liegen, nur der Index kennt sie nicht mehr.

Die Ausnahme ist notwendig, nicht kosmetisch: NEUER_TITEL.md ist seit dem
Zusammenfuehren der Titeltexte die EINE Quelle, aus der titeltexte_04.py die
PDF-Titelseite und den Hero-Block der Startseite speist. Ohne die Datei bricht
lies_titeltexte() mit "Die Quelle des Titeltexts fehlt" ab - ein frischer Klon
koennte das Buch nicht mehr bauen.

Deshalb 'Kritik_und_Verbesserungsvorschlaege/*' plus Gegenausnahme statt eines
Verzeichnismusters: Git kann eine Datei nicht zurueckholen, deren Verzeichnis
als Ganzes ausgeschlossen ist.

Gegengeprueft mit einem simulierten Klon (git checkout-index in ein leeres
Verzeichnis): Dort liegt aus dem Verzeichnis nur NEUER_TITEL.md, und
build_version_04.py --check liefert dieselben Zahlen wie lokal - 5 Teile,
23 Kapitel, 6 Anhaenge, 998 Querverweise, 456 Indexmarken.

CLAUDE.md und README.md beschrieben das Verzeichnis noch als vollstaendige
Quelle; beide sind nachgezogen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
dschlueter 2026-09-08 22:22:35 +02:00
commit 7f32ef3b8d
8 changed files with 19 additions and 813 deletions

View file

@ -33,9 +33,10 @@ Operations_Research_mit_Python_Version_04.pdf generiert: PDF (xelatex)
OR_HTML_04/ generiert: Mehrseiten-Website
Operations_Research_mit_Python_Version_04_Programme/ generiert: Beispielprogramme
Notebooks_04/ generiert: ein .ipynb je Kapitel
Kritik_und_Verbesserungsvorschlaege/ Quelle: Rezension, Verbesserungsvorschläge,
NEUER_TITEL.md - die EINE Quelle des
Titeltexts (PDF-Titelseite + Startseite)
Kritik_und_Verbesserungsvorschlaege/ NEUER_TITEL.md - die EINE Quelle des
Titeltexts (PDF-Titelseite + Startseite).
Nur diese Datei ist versioniert; Rezension und
Verbesserungsvorschläge stehen in .gitignore
pyproject.toml Quelle: Abhängigkeiten in Gruppen
Dockerfile, .dockerignore Quelle: Kurs-Image (Programme + JupyterLab)
LICENSE, LICENSE-TEXT.md MIT fuer Code, CC BY-SA 4.0 fuer den Text
@ -119,7 +120,9 @@ bewacht jede Familie. Konkret:
existieren, und kein Verweis darf auf das Glossar selbst zeigen. Begriffe, die es nur im
Glossar gibt, stehen ausdrücklich in `NUR_IM_GLOSSAR` — sonst ließe sich ein solcher Fall
nicht von einem Tippfehler unterscheiden.
* **Der Titeltext steht in `Kritik_und_Verbesserungsvorschlaege/NEUER_TITEL.md`** und
* **Der Titeltext steht in `Kritik_und_Verbesserungsvorschlaege/NEUER_TITEL.md`** — die
einzige versionierte Datei dieses Verzeichnisses, und zwar genau deshalb: Ohne sie bricht
der Bau ab, bevor er die erste Seite schreibt. Der Titel steht dort und
nirgends sonst. `titeltexte_04.py` liest ihn; die PDF-Titelseite
(`bilder_04/erzeuge_titelseite.py`) und der Hero-Block der Startseite
(`baue_landingpage()`) speisen sich daraus. Eine Titeländerung wird **einmal** dort