diff --git a/BEDIENUNGSANLEITUNG.md b/BEDIENUNGSANLEITUNG.md index 07f9cec..ac3707b 100644 --- a/BEDIENUNGSANLEITUNG.md +++ b/BEDIENUNGSANLEITUNG.md @@ -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: diff --git a/README.md b/README.md index 0e8650e..1beb872 100644 --- a/README.md +++ b/README.md @@ -350,8 +350,10 @@ Verlustfreiheit behauptet (`lossless: false`). - Fehlerhafte Einrückungen der Vorlage werden zeichengetreu übernommen. Druck-Fortsetzungszeichen (`↪`/`➥`) am Zeilenanfang werden dagegen standardmäßig aufgelöst (siehe `--keep-wrap-markers`). - Formelbilder ohne TeX-Alternativtext bleiben Bilder. -- Audio/Video sind implementiert, aber nur mit synthetischen Daten geprüft. Für Bildbände gibt es - bislang keine Testbücher. +- Audio/Video sind implementiert, aber nur mit synthetischen Daten geprüft. Bildbände sind mit einem + realen Buch geprüft (434 Bilder, 246 Figuren, ausführliche Alternativtexte). +- Rein per CSS erzeugte Inhalte (`::before`/`content:`, z. B. automatische Schrittnummern) werden nicht + übernommen, weil CSS nicht ausgewertet wird. ## Architektur