Watch

dschlueter 6a0e9587f5 docs: Dokumentation nach Projektstandard, MIT-Lizenz

- README knapp: Zweck, Schnellstart, Stand, Abschnitt "Documentation", Lizenz
- FUNKTIONSWEISE.md neu: Aufbau, Datenfluss (Mermaid), Entscheidungsregel,
  Normalform, elastischer Bildvergleich, Quellen, Sicherheit, Messungen,
  Designentscheidungen, Grenzen
- BEDIENUNGSANLEITUNG gegliedert: Installation, Modellserver, Benutzung,
  Konfiguration (Umgebungsvariablen, workspace.json), Betrieb, Werkzeuge,
  Fehlersuche mit echten Meldungen und Rückgabecodes
- CHANGELOG im Format Keep a Changelog mit "Beim Update zu tun"
- LICENSE (MIT)
- cli.py: Hilfetexte beschreiben die Regel p2t und z-ai/glm-4.6v statt des
  Pixelvergleichs und gemini-2.5-flash
- requirements.txt: requests ergänzt

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

2026-10-20 12:26:49 +02:00

2.9 KiB

Raw Blame History

formula_img2latex

Nachbearbeitungs-Werkzeug für die Markdown-Ausgaben von epub2md und pdf2md: Formeln, die nur als Bild vorliegen, werden durch LaTeX ersetzt. Beim Neubau als EPUB oder PDF passen sie dann in Größe und Schrift zum Text.

Nur bestätigte Formeln: Das Formel-OCR pix2text liest jede Formel, das Bildmodell Qwen3-VL muss dieselbe Formel lesen (bei Uneinigkeit darf Gemma 4 pix2text bestätigen), und ein grober Bildabgleich darf nicht widersprechen. Alles andere geht in eine Review-Galerie oder bleibt Bild.
Annahmeregel: jedes Zeichen richtig und an der richtigen Stelle; Abstände, Längen, Schriftgröße, kursiv/aufrecht und Fettdruck dürfen abweichen.
Lokal: pix2text im Prozess, Qwen und Gemma über llama.cpp; keine Buchinhalte verlassen den Rechner.
Wiederholbar und umkehrbar: Ergebnisse liegen in einem Arbeitsordner neben der Ausgabe, apply schreibt aus einer Sicherung, revert stellt den alten Stand wieder her.
PDF-Bücher: Mit pdf2md --formulas werden auch Formeln im Fließtext und in Merkkästen erfasst.

Schnellstart

Voraussetzungen und das Starten der Modellserver: BEDIENUNGSANLEITUNG.md.

sudo apt install texlive-latex-extra texlive-fonts-extra texlive-science pandoc dvipng
pip install -r requirements.txt
pip install "pix2text[multilingual]" && pip install --no-deps pix2tex munch

python3 formula_img2latex.py run    ~/Python_Programs/epub2md/output/buch   # lesen, prüfen, entscheiden
python3 formula_img2latex.py review ~/Python_Programs/epub2md/output/buch   # Zweifelsfälle im Browser
python3 formula_img2latex.py apply  ~/Python_Programs/epub2md/output/buch   # Formeln ins Markdown schreiben

Stand

Version 0.4.0 plus unveröffentlichte Änderungen (siehe CHANGELOG.md). An Formelbildern mit bekannter Lösung (Göllmann, Springer) werden 88–89 % automatisch ersetzt, keine davon falsch. Ganze Bücher: Gehrke-Brückenkurs (EPUB) 63 %, alle 62 von Hand geprüften korrekt; Corral mit pdf2md --formulas 79 % (Stichprobe). Einzelheiten: FUNKTIONSWEISE.md, Messungen.

Documentation

Dokument	Inhalt
BEDIENUNGSANLEITUNG.md	Installation, Modellserver, ein Buch bearbeiten, Konfiguration, Betrieb, Fehlersuche
FUNKTIONSWEISE.md	Aufbau, Datenfluss, Entscheidungsregel, Normalform, Bildabgleich, Messungen, Designentscheidungen, Grenzen
CHANGELOG.md	Änderungen je Version und was beim Update zu tun ist
LICENSE	MIT
`Idee/`	ursprüngliche Problemstellung und Planung

Entwicklung

pip install -r requirements-dev.txt
python3 -m pytest -q     # ca. 45 s; synthetische Bilder, kein Modellserver, keine Buchinhalte

License

MIT, siehe LICENSE.

2.9 KiB Raw Blame History Unescape Escape