dschlueter/epub2md
Watch
1
0
Fork
You've already forked epub2md
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
epub2md/CHANGELOG.md
dschlueter 99c3c609ca feat: Inhaltsverzeichnis nach Cover, Titelseite und Impressum (pandoc/book.lua) 
Pandocs --toc setzt Inhaltsverzeichnis und Titelkopf immer vor den
Buchtext, also vor Cover, Titelseite und Impressum.

- epub2md_merge.py: Kapiteltypen aus manifest.json; Platzhalter
  <div id="epub2md-toc"> hinter dem Vorspann und, ohne eigene Titelseite,
  <div id="epub2md-titlepage"> hinter dem Cover; --toc-Liste an derselben Stelle
- pandoc/book.lua (HTML/weasyprint, statt --toc): baut dort das
  Inhaltsverzeichnis, lässt Pandocs Titelkopf bei eigener Titelseite weg,
  Cover ohne Bildunterschrift, Kapitelanker → div.chapter-start;
  andere Formate: nur Platzhalter entfernen
- print.css: jedes Kapitel (auch Cover/Titelseite/Impressum) und das
  Verzeichnis auf neuer Seite, Verzeichnis mit Punktlinie und Seitenzahl
- Buch-README, Bedienungsanleitung, README: Befehle mit book.lua

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 06:27:27 +02:00

4.6 KiB
Raw Blame History

Änderungsprotokoll

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

Unveröffentlicht

Neu

  • pandoc/book.lua: Inhaltsverzeichnis wie im gedruckten Buch nach Cover, Titelseite und Impressum statt davor (Pandocs --toc setzt es immer an den Anfang). epub2md_merge.py markiert dafür das Ende des Vorspanns; ohne eigene Titelseite kommt Pandocs Titelkopf hinter das Cover. Jedes Kapitel, auch Cover, Titelseite und Impressum, beginnt mit print.css auf einer neuen Seite; das Inhaltsverzeichnis hat Seitenzahlen. Mit epub2md_merge.py --toc steht dessen Verzeichnis an derselben Stelle.
  • 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.

Geändert

  • epub2md_merge.py kürzt ISO-Zeitstempel im Buch-Kopf (2025-01-13T08:00:00+00:00 → 13.01.2025, bei nicht-deutschen Büchern 2025-01-13), damit die Pandoc-Titelseite ein lesbares Datum zeigt.
  • Seitenmarken (--page-markers) aus einem Kastentitel stehen jetzt vor dem Kasten statt im fetten Titel, wie bei Überschriften.

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.