docs: Bildband geprüft, Rezept für Bildbände in der Bedienungsanleitung

Bildband-EPUB (434 Bilder, 246 Figuren) konvertiert und validiert:
- 0 Warnungen, 968 Links/Bilder gültig
- alle 442 img-Elemente ausgegeben, 13/13 Bildunterschriften
- Gesamtdatei per Pandoc nach EPUB mit 433 Bildern
Kein Codefehler gefunden. README-Einschränkungen aktualisiert
(CSS-generierte Inhalte werden nicht übernommen).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Dieter Schlüter 2026-10-05 20:57:35 +02:00
commit b0421b849c

View file

@ -185,6 +185,22 @@ Formeln, die im E-Book als echte Formeln (MathML oder TeX) vorliegen, werden zu
| Formeln als MathML (für Browser/HTML) | `--math mathml` |
| Formeln möglichst als Bilder | `--math image` |
### Bildband (viele Bilder)
```bash
python3 epub2md.py bildband.epub output/bildband --chapter-level 3
```
- Jedes Bild wird genau einmal nach `media/images/` kopiert, auch wenn es mehrfach vorkommt. Die
Dateinamen beginnen mit einer laufenden Nummer, gefolgt von einem Stichwort aus dem Bildtext.
- Alternativtexte (Bildbeschreibungen für Screenreader) und Bildunterschriften bleiben erhalten.
Unterschriften erscheinen kursiv unter dem Bild.
- Bildbände haben oft sehr lange Großkapitel mit Hunderten Bildern. Mit `--chapter-level 2` oder `3`
entsteht eine Datei pro Thema bzw. pro Projekt. Das ist übersichtlicher und lädt schneller.
Beispiel: 9 Dateien beim Standard, 29 bei Stufe 2 und 78 bei Stufe 3.
- Bilder, die im E-Book zwar enthalten, aber nirgends eingebunden sind, werden trotzdem gespeichert.
Im Bericht sind sie als `unreferenced` gekennzeichnet.
### Buch mit vielen Fußnoten
Standardmäßig stehen die Fußnoten am Ende des jeweiligen Kapitels. Alternativen: