Glossar und Literatur trennen, Menue um Glossar und ZIP-Download ergaenzen

94_Anhang_Glossar_und_Literatur.md enthielt zwei verschiedene Nachschlagewerke
in einer Datei. Jetzt sind es zwei Anhaenge: E = Glossar (92 Eintraege),
F = Literaturverzeichnis (6 Kategorien). Aus 5 Anhaengen werden 6, aus 36
Kapiteldateien 37.

Die Teilung war billig: Die Datei trug bereits zwei eigenstaendige
Ueberschriften mit nichts als einem --- dazwischen, und im ganzen Buch gab es
genau einen {ref:anhang:glossar-literatur} - die Weiter-mit-Zeile im
Spickzettel. Geprueft: keine Inhaltszeile verloren, alle 92 Glossareintraege
auf der neuen Seite, Indexmarken unveraendert bei 328.

Das Seitenleisten-Menue bekommt zwei Eintraege:

  Beispielprogramme
  Notebooks
    Download Notebooks als ZIP     <- neu, eingerueckt
  Glossar                          <- neu
  Stichwortverzeichnis
  Gesamtdokument (eine Seite)
  Download als PDF

Der ZIP-Link benutzt dieselbe Konstante wie baue_notebooks_seite() beim
Schreiben des Archivs, damit Link und Datei nicht auseinanderlaufen. Das
Glossar erscheint absichtlich doppelt: hier als Abkuerzung neben dem
Stichwortverzeichnis, und unten in der Gruppe "Anhaenge", weil es ein Anhang
ist.

Die verwaiste anhang-glossar-literatur.html von Hand entfernt - der Build
raeumt alte Seiten nicht ab.

Nebenbefund, in PROGRESS.md festgehalten: OR_HTML_04/assets/site.css ist eine
von Hand gepflegte Quelle, die im als "generiert" beschriebenen Verzeichnis
liegt. Der Build schreibt sie nie. Dasselbe gilt fuer site.js, icons.svg,
highlight.css und plotly.min.js.

--check: 5 Teile, 23 Kapitel, 6 Anhaenge, 296 Abschnitte, 825 Querverweise,
328 Indexmarken, 37 Dateien, 28.544 Zeilen, 305 Hauptueberschriften, keine
Warnung. PDF unveraendert 759 Seiten.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
dschlueter 2026-09-08 15:48:57 +02:00
commit b6de2802fc
55 changed files with 365 additions and 209 deletions

View file

@ -29,8 +29,8 @@ git status --short
# 2. Struktur, Querverweise, Codezäune
python3 Operations_Research_mit_Python_Version_04/build_version_04.py --check
# Soll: 5 Teile, 23 Kapitel, 5 Anhänge, 292 Abschnitte, 703 Querverweise,
# 325 Indexmarken, 31 Dateien, 27.013 Zeilen, 276 Hauptüberschriften
# Soll: 5 Teile, 23 Kapitel, 6 Anhänge, 296 Abschnitte, 825 Querverweise,
# 328 Indexmarken, 37 Dateien, 28.544 Zeilen, 305 Hauptüberschriften
# KEINE Zeile mit "WARNUNG", "FEHLENDE DATEIEN" oder "Nicht eingebundene".
# 3. Laufen alle Programme? (einige Minuten; die Finanzkapitel brauchen Internet)
@ -74,12 +74,12 @@ sie unerwartet ab, ist etwas kaputtgegangen.
| Kennzahl | Version 03 | Version 04 (heute) |
| --- | --- | --- |
| Kapiteldateien | 22 | **36** (31 + 5 Teil-Synthesen) |
| Kapiteldateien | 22 | **37** (31 + 5 Teil-Synthesen + geteilter Anhang E/F) |
| Kapitel | 15 | **23** |
| Anhänge | 4 | **5** |
| Zeilen im Gesamtdokument | 11 082 | **28 547** |
| Anhänge | 4 | **6** |
| Zeilen im Gesamtdokument | 11 082 | **28 544** |
| Größe des Gesamtdokuments | 606 KB | **1 620 KB** |
| Hauptüberschriften | 131 | **306** |
| Hauptüberschriften | 131 | **305** |
| registrierte Abschnitte | 122 | **296** |
| aufgelöste Querverweise | 314 | **825** (0 unaufgelöst) |
| Indexmarken | 295 | **328** |
@ -1331,7 +1331,7 @@ pytest-Tests grün, Version 03 unberührt.
**Alle Phasen sind abgeschlossen** — die sechs des Umbaus, dazu Phase 6 bis 8 aus
`Verbesserungen_02.md`/`_03.md`. `Version_04/` ist seit dem 08.09.2026 ein eigenes
Git-Repository. 23 Kapitel, 5 Anhänge, 5 Teil-Synthesen, **76** lauffähige Programme,
Git-Repository. 23 Kapitel, 6 Anhänge, 5 Teil-Synthesen, **76** lauffähige Programme,
141 Aufgaben mit 141 Lösungen, 33 Diagramme, PDF mit 759 Seiten, Website mit vier
interaktiven Figuren.
@ -1993,6 +1993,45 @@ Geprüft: 25 gelistete Notebooks, 0 tote Links auf der Seite, ZIP mit 25 Einträ
identischen Zeitstempeln, Seitenleisteneintrag auf allen 40 Seiten mit Seitenleiste
(`gesamtdokument.html` hat konstruktionsbedingt keine).
### ✅ Glossar und Literatur getrennt, Menü ergänzt
`94_Anhang_Glossar_und_Literatur.md` enthielt zwei verschiedene Nachschlagewerke in einer
Datei. Jetzt sind es zwei Anhänge: **E = Glossar** (92 Einträge), **F =
Literaturverzeichnis** (6 Kategorien) — aus 5 Anhängen wurden 6.
**Die Teilung war billiger als erwartet.** Die Datei trug bereits zwei eigenständige
Überschriften mit nichts als einem `---` dazwischen, und im ganzen Buch gab es **genau
einen** `{ref:anhang:glossar-literatur}` — die „Weiter mit"-Zeile im Spickzettel. Die 47
Treffer in `OR_HTML_04/` waren erzeugt und lösten sich beim Bau von selbst auf. Geprüft:
keine einzige Inhaltszeile ging verloren, alle 92 Glossareinträge stehen auf der neuen
Seite, die Zahl der Indexmarken blieb bei 328.
**Das Menü der Website** hat zwei Einträge mehr:
```
Beispielprogramme
Notebooks
↳ Download Notebooks als ZIP
Glossar
Stichwortverzeichnis
Gesamtdokument (eine Seite)
Download als PDF
```
Der ZIP-Link benutzt dieselbe Konstante wie `baue_notebooks_seite()` beim Schreiben des
Archivs — so können Link und Datei nicht auseinanderlaufen. Das Glossar erscheint
**absichtlich doppelt**: hier oben als Abkürzung neben dem Stichwortverzeichnis, weil beide
dasselbe leisten, und unten in der Gruppe „Anhänge", weil es ein Anhang ist.
**Nebenbefund: `OR_HTML_04/assets/site.css` ist eine Quelle, keine erzeugte Datei.** Der
Build schreibt sie nicht (Zeitstempel vom 06.09., während `programme.js` bei jedem Lauf
neu entsteht). Dasselbe gilt für `site.js`, `icons.svg`, `highlight.css` und
`plotly.min.js`. Sie liegen im als „generiert" beschriebenen Verzeichnis, sind aber von Hand
gepflegt bzw. mitgeliefert — wer `OR_HTML_04/` löscht und neu baut, verliert sie.
Die alte `anhang-glossar-literatur.html` musste von Hand entfernt werden; der Build räumt
verwaiste Seiten nicht ab.
---
## 8. Commit-Historie des V04-Strangs