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:
parent
84821a2fcd
commit
b0421b849c
2 changed files with 20 additions and 2 deletions
|
|
@ -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 als MathML (für Browser/HTML) | `--math mathml` |
|
||||||
| Formeln möglichst als Bilder | `--math image` |
|
| 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
|
### Buch mit vielen Fußnoten
|
||||||
|
|
||||||
Standardmäßig stehen die Fußnoten am Ende des jeweiligen Kapitels. Alternativen:
|
Standardmäßig stehen die Fußnoten am Ende des jeweiligen Kapitels. Alternativen:
|
||||||
|
|
|
||||||
|
|
@ -350,8 +350,10 @@ Verlustfreiheit behauptet (`lossless: false`).
|
||||||
- Fehlerhafte Einrückungen der Vorlage werden zeichengetreu übernommen. Druck-Fortsetzungszeichen
|
- Fehlerhafte Einrückungen der Vorlage werden zeichengetreu übernommen. Druck-Fortsetzungszeichen
|
||||||
(`↪`/`➥`) am Zeilenanfang werden dagegen standardmäßig aufgelöst (siehe `--keep-wrap-markers`).
|
(`↪`/`➥`) am Zeilenanfang werden dagegen standardmäßig aufgelöst (siehe `--keep-wrap-markers`).
|
||||||
- Formelbilder ohne TeX-Alternativtext bleiben Bilder.
|
- Formelbilder ohne TeX-Alternativtext bleiben Bilder.
|
||||||
- Audio/Video sind implementiert, aber nur mit synthetischen Daten geprüft. Für Bildbände gibt es
|
- Audio/Video sind implementiert, aber nur mit synthetischen Daten geprüft. Bildbände sind mit einem
|
||||||
bislang keine Testbücher.
|
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
|
## Architektur
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue