dschlueter/formula_img2latex
Watch
1
0
Fork
You've already forked formula_img2latex
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
Nachbearbeitungs-Werkzeug für die Markdown-Ausgaben von [epub2md](https://kitux.de/forgejo/dschlueter/epub2md) und [pdf2md](https://kitux.de/forgejo/dschlueter/pdf2md): Formeln, die nur als Bild vorliegen, werden durch LaTeX ersetzt
10 commits 1 branch 0 tags 301 KiB
  • Python 97.1%
  • HTML 2.9%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
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
formula_img2latex docs: Dokumentation nach Projektstandard, MIT-Lizenz 2026-10-20 12:26:49 +02:00
Idee feat: formula_img2latex 0.1.0 – Formelbilder geprüft durch LaTeX ersetzen 2026-10-07 03:00:40 +02:00
tests feat: Formeln im Fließtext (pdf2md --formulas), etwa dreimal schneller 2026-10-10 03:31:57 +02:00
tools feat: Formeln im Fließtext (pdf2md --formulas), etwa dreimal schneller 2026-10-10 03:31:57 +02:00
.gitignore feat: Konsens zweier Bildmodelle als Entscheider, elastischer Bildvergleich 2026-10-07 05:01:27 +02:00
BEDIENUNGSANLEITUNG.md docs: Dokumentation nach Projektstandard, MIT-Lizenz 2026-10-20 12:26:49 +02:00
CHANGELOG.md docs: Dokumentation nach Projektstandard, MIT-Lizenz 2026-10-20 12:26:49 +02:00
formula_img2latex.py feat: formula_img2latex 0.1.0 – Formelbilder geprüft durch LaTeX ersetzen 2026-10-07 03:00:40 +02:00
FUNKTIONSWEISE.md docs: Dokumentation nach Projektstandard, MIT-Lizenz 2026-10-20 12:26:49 +02:00
LICENSE docs: Dokumentation nach Projektstandard, MIT-Lizenz 2026-10-20 12:26:49 +02:00
pytest.ini feat: formula_img2latex 0.1.0 – Formelbilder geprüft durch LaTeX ersetzen 2026-10-07 03:00:40 +02:00
README.md docs: Dokumentation nach Projektstandard, MIT-Lizenz 2026-10-20 12:26:49 +02:00
requirements-dev.txt feat: formula_img2latex 0.1.0 – Formelbilder geprüft durch LaTeX ersetzen 2026-10-07 03:00:40 +02:00
requirements.txt docs: Dokumentation nach Projektstandard, MIT-Lizenz 2026-10-20 12:26:49 +02:00

README.md

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.