From 7835cde1ca6885e291f664f7af35f1aabfda15cb Mon Sep 17 00:00:00 2001 From: dschlueter Date: Tue, 6 Oct 2026 00:38:33 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20Bedienungsanleitung=20um=20Umwandlung?= =?UTF-8?q?=20in=20andere=20Formate=20erg=C3=A4nzt?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Getestete Befehle für HTML, EPUB, Word, ODT, PDF (LaTeX über HTML bzw. weasyprint) und Kindle (AZW3 via Calibre), aus der Gesamtdatei wie aus den Kapiteldateien, mit Installationshinweisen. Co-Authored-By: Claude Opus 5.5 --- BEDIENUNGSANLEITUNG.md | 67 +++++++++++++++++++++++++++++++++++------- 1 file changed, 56 insertions(+), 11 deletions(-) diff --git a/BEDIENUNGSANLEITUNG.md b/BEDIENUNGSANLEITUNG.md index 3b99da8..030c819 100644 --- a/BEDIENUNGSANLEITUNG.md +++ b/BEDIENUNGSANLEITUNG.md @@ -14,7 +14,7 @@ was du mit dem Ergebnis anfangen kannst. Technische Details stehen in der [READM - auf Wunsch zusätzlich **eine einzige Markdown-Datei mit dem ganzen Buch** (`epub2md_merge.py`) Markdown ist reiner Text mit einfachen Formatierungszeichen. Du kannst ihn in jedem Editor lesen, -in Obsidian ablegen, mit Git versionieren, mit Pandoc in HTML/PDF/Word umwandeln oder an ein lokales +in Obsidian ablegen, mit Git versionieren, mit Pandoc in HTML/PDF/EPUB/Word umwandeln oder an ein lokales Sprachmodell (RAG) übergeben. Was das Programm **nicht** kann: @@ -224,24 +224,69 @@ erscheinen als einzelne Notizen, Bilder und Links auf andere Kapitel funktionier als Eigenschaften angezeigt. Sprünge an eine bestimmte Stelle *innerhalb* eines Kapitels (HTML-Anker wie ``) unterstützt Obsidian nur eingeschränkt. Solche Links öffnen dann einfach das Kapitel. -### Mit Pandoc in HTML, PDF oder EPUB umwandeln +### In andere Formate umwandeln (HTML, PDF, EPUB, Word …) -Am einfachsten über die Gesamtdatei. Wechsle dazu in den Ausgabeordner, damit die Bildpfade stimmen: +Dafür eignet sich **Pandoc**; für Kindle-Formate kommt **Calibre** (`ebook-convert`) dazu. Beide sind +eigenständige Programme und nicht Teil von epub2md. Installation unter Ubuntu: +`sudo apt install pandoc calibre`. Für PDF zusätzlich entweder LaTeX +(`sudo apt install texlive-xetex`) oder `pip install weasyprint`. + +> **Wichtig:** Die Befehle im Ordner der jeweiligen Datei ausführen. Sonst findet Pandoc die Bilder nicht, +> weil die Bildpfade relativ angegeben sind. + +#### Aus der Gesamtdatei (empfohlen) ```bash -python3 epub2md_merge.py output/meinbuch +python3 epub2md_merge.py output/meinbuch # erzeugt output/meinbuch/meinbuch.md cd output/meinbuch -pandoc meinbuch.md --toc -s -o meinbuch.html # Webseite -pandoc meinbuch.md --toc -o meinbuch.docx # Word -pandoc meinbuch.md -s -o meinbuch.html && \ - pandoc meinbuch.html --toc --pdf-engine=xelatex -o meinbuch.pdf # PDF (LaTeX nötig) ``` +`meinbuch.md` steht im Folgenden für den Namen der Gesamtdatei. Er entspricht dem Namen des +Original-E-Books. + +| Ziel | Befehl | +| --- | --- | +| Webseite (HTML) | `pandoc meinbuch.md -s --toc -o meinbuch.html` | +| Webseite mit Formeln | `pandoc meinbuch.md -s --toc --mathml -o meinbuch.html` | +| E-Book (EPUB) | `pandoc meinbuch.md --toc -o meinbuch.epub` | +| Word | `pandoc meinbuch.md -o meinbuch.docx` | +| LibreOffice | `pandoc meinbuch.md -o meinbuch.odt` | +| PDF mit LaTeX | `pandoc meinbuch.md -s -o meinbuch.html && pandoc meinbuch.html --toc --pdf-engine=xelatex -o meinbuch.pdf` | +| PDF ohne LaTeX | `pandoc meinbuch.md --toc --pdf-engine=weasyprint -o meinbuch.pdf` | +| Kindle (AZW3) | `pandoc meinbuch.md --toc -o meinbuch.epub && ebook-convert meinbuch.epub meinbuch.azw3` | + +**Zum PDF:** + +- **Mit LaTeX** immer den Zwischenschritt über HTML nehmen, wie in der Tabelle. Beim direkten Weg von + Markdown nach LaTeX lässt Pandoc komplexe Tabellen weg, und Querverweise im PDF funktionieren nicht. Bei + Büchern mit Formeln ist der LaTeX-Weg die beste Wahl. +- **Mit weasyprint** genügt ein Schritt; Tabellen bleiben erhalten. Für Bücher mit vielen Formeln ist der + LaTeX-Weg sicherer. + Bei Büchern mit Formeln für HTML zusätzlich `--mathml` angeben, sonst bleiben Matrizen als TeX-Text stehen. -Für ein PDF immer den Umweg über HTML nehmen, wie oben gezeigt. Beim direkten Weg von Markdown nach PDF -lässt Pandoc komplexe Tabellen weg, und Querverweise im PDF funktionieren nicht. Die `README.md` im -Ausgabeordner enthält die passenden Befehle für dein Buch. +#### Direkt aus den Kapiteldateien + +Ohne Gesamtdatei geht es auch. Dann im Ordner `chapters/` arbeiten und die Buchdaten aus +`metadata.yaml` mitgeben: + +```bash +cd output/meinbuch/chapters +pandoc *.md --metadata-file=../metadata.yaml -s --toc -o ../meinbuch.html +pandoc *.md --metadata-file=../metadata.yaml --toc -o ../meinbuch.epub +``` + +Das Ergebnis entspricht dem der Gesamtdatei. Querverweise zwischen Kapiteln funktionieren aber nur in der +Gesamtdatei zuverlässig. Bei Büchern mit vielen Verweisen also lieber die Gesamtdatei verwenden. Für PDF +gilt hier derselbe Umweg über HTML. + +#### Weitere Formate und Tipps + +- Pandoc kennt viele weitere Formate, z. B. `.rtf`, `.txt`, `.tex` (LaTeX-Quelltext), `.rst` oder + `.adoc`. Meist genügt `-o datei.`. Alle Formate zeigt `pandoc --list-output-formats`. +- Wurde mit `--math tex` umgewandelt, braucht Pandoc zusätzlich `-f markdown+tex_math_single_backslash`. +- Die `README.md` im Ausgabeordner enthält im Abschnitt „Weiterverarbeitung“ die passenden Befehle mit + dem richtigen Dateinamen. Bei Büchern mit Formeln steht `--mathml` dort schon dabei. ### Für ein lokales Sprachmodell (RAG)