epub2md/CHANGELOG.md

Änderungsprotokoll

Alle nennenswerten Änderungen an epub2md. Format nach Keep a Changelog, Versionsnummern nach Semantic Versioning.

Unveröffentlicht

Geändert

• Seitenmarken (--page-markers) aus einem Kastentitel stehen jetzt vor dem Kasten statt im fetten Titel, wie bei Überschriften.

Neu

• pandoc/print.css: Druck-Layout für PDFs mit weasyprint (A4, Seitenzahlen, Kapitel auf neuer Seite, Silbentrennung außer in Code, umbrechende Codezeilen). Die Buch-README enthält den passenden Befehl.

Behoben

• pandoc/callouts.lua: Die Kästen blieben ohne Rahmen, wenn man Pandoc zusätzlich -H/--include-in-header übergab, und im EPUB hatten nur die Titelseite, nicht die Kapitel, das Kasten-CSS. Das CSS steht jetzt in pandoc/callouts.css; der Filter setzt es bei HTML an den Anfang des Dokuments und fügt es bei EPUB den Stylesheets hinzu (zusammen mit Pandocs Standard-CSS bzw. zu eigenen css:-Angaben).

Dokumentation

• --no-css-emphasis lässt <mark>-Markierungen bestehen; diese steuert --styles.

0.2.0 – 2026-10-06

Schwerpunkt: Typografie und Gestaltung des Buches im Markdown abbilden.

Neu

• Hervorhebungen aus dem CSS des Buches (epub2md/css.py): fett, kursiv, unterstrichen, durchgestrichen, hoch-/tiefgestellt und Festbreitenschrift werden auch übernommen, wenn der Verlag sie nur per Stylesheet setzt. Per CSS ausgeblendete Elemente (display:none) entfallen. Abschaltbar mit --no-css-emphasis.
• Infokästen (Tipp, Hinweis, Warnung, Exkurs …) als GitHub-/Obsidian-Callouts > [!TIP], wahlweise als Zitatblock, HTML-div oder normaler Text: --boxes {callout,quote,html,plain}.
• Pandoc-Filter pandoc/callouts.lua: zeichnet die Kästen in HTML/EPUB als gerahmte Kästen, in LaTeX/PDF, Word und ODT als Zitatblock mit Titel. Die Buch-README nennt ihn in den Pandoc-Befehlen.
• Farben, Schriftarten, Schriftgrößen, Kapitälchen, Ausrichtung und Fremdsprache als HTML-Stil: --styles html. Standard semantic übernimmt nur Hintergrundmarkierungen (<mark>).
• Szenenwechsel (Leerabsätze, Ornamente) als * * *, Gedichte als Zitatblock mit Zeilenumbrüchen.
• Seitenzahlen der Druckausgabe als [S. 123] oder <!-- S. 123 -->: --page-markers {none,visible,comment}.
• Unsichtbare Zeichen (Nullbreiten-Leerzeichen, weiche Trennstriche) werden im Fließtext entfernt, im Code nicht. Abschaltbar mit --keep-invisible-chars.
• Verzeichnisse (Quellen, Literatur, Register, Glossar) unterhalb von --chapter-level werden eigene Dateien.
• Bericht: neue Abschnitte text_cleanup, css und layout.

Geändert

• Kastentitel ohne dekorative Symbole wie [»]. Der Kastentyp aus der Verlagsklasse hat Vorrang vor einem Typwort im Titel.
• Zwischen Feld-Spans wird kein Leerzeichen mehr eingefügt, wenn einer davon per CSS ausgeblendet ist.

Dokumentation

• Bedienungsanleitung: Umwandlung in andere Formate (HTML, PDF, EPUB, Word, Kindle), Infokästen, Farben/Schriften, Seitenzahlen.

0.1.0 – 2026-10-06

Erste Fassung.

• epub2md.py: DRM-freie EPUB 2/3 → kapitelweises Markdown mit Medien, metadata.yaml, manifest.json, conversion-report.json und Diagnose-Dateien; Code zeichengetreu, MathML → TeX, Fußnoten-Modi, sichere ZIP-/XML-Verarbeitung.
• epub2md_merge.py: Gesamtdatei <Original>.md aus einem Ausgabeordner.
• Optionen --code-language, --keep-wrap-markers; Warnung chapter-large; Titel überschriftsloser Seiten aus dem Inhalt.
• Alle Befunde der QA-Prüfungen (R1–R7, QA2-01 bis QA2-19) behoben oder abgemildert.
• README und Bedienungsanleitung.