From 7ab88b6d733f7035c33031e9c4918794ccb7b2c6 Mon Sep 17 00:00:00 2001 From: torsten Date: Fri, 20 Nov 2026 17:30:35 +0100 Subject: [PATCH] =?UTF-8?q?tools:=20Schriften=20plattformunabh=C3=A4ngig?= =?UTF-8?q?=20finden,=20Setup=20f=C3=BCr=20macOS=20dokumentieren?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - tools/fontpicker.py sucht DejaVu über WESTREICHE_FONT_DIR, Linux-Pfade und ~/Library/Fonts statt festem /usr/share/fonts/truetype/dejavu - PDF-Skripte (Almanach, Liturgie, SL-Tabellen, SL-Schirm) nutzen den Finder - tools/requirements.txt (reportlab, markdown, pillow) + Setup-Abschnitt in AGENTS.md inkl. ghostscript, pandoc und font-dejavu für macOS --- AGENTS.md | 15 ++++++++++ tools/build_sl_schirm.py | 4 ++- tools/build_sl_tabellen.py | 4 ++- tools/build_zauber_almanach.py | 4 ++- tools/fontpicker.py | 55 ++++++++++++++++++++++++++++++++++ tools/requirements.txt | 12 ++++++++ 6 files changed, 91 insertions(+), 3 deletions(-) create mode 100644 tools/fontpicker.py create mode 100644 tools/requirements.txt diff --git a/AGENTS.md b/AGENTS.md index d333810..7711412 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -91,6 +91,21 @@ Wichtige Einstiege: `RPG/2-Spieler/` (je ein Ordner pro Spieler), ## Tooling +**Setup (einmalig, gilt für Linux und macOS):** + +```bash +python3 -m venv .venv +.venv/bin/pip install -r tools/requirements.txt # reportlab, markdown, pillow +``` + +Systemwerkzeuge: `ghostscript` (A4-Skalierung in den PDF-Builds), `pandoc` +(ODT-Konvertierung), DejaVu-Schriften. Auf macOS per Homebrew: +`brew install ghostscript pandoc && brew install --cask font-dejavu`. Die +Schriften suchen die Skripte über `tools/fontpicker.py` (Linux-Pfade, +`~/Library/Fonts`, Override `WESTREICHE_FONT_DIR`). Alle PDF-Skripte und +`build_site.py` mit `.venv/bin/python` starten – das System-Python bringt weder +`reportlab` noch `markdown` mit. + - `tools/md2odt.sh`, `tools/make_reference_odt.py`, `tools/autowidth.lua`: Markdown → ODT-Konvertierung für Druckmaterial. - `tools/build_zauber_almanach.py`: erzeugt das PDF-Handout diff --git a/tools/build_sl_schirm.py b/tools/build_sl_schirm.py index 42c87f5..9ef33eb 100644 --- a/tools/build_sl_schirm.py +++ b/tools/build_sl_schirm.py @@ -53,7 +53,9 @@ PREP = VAULT / "7-Prep" / "prep_2026-11-20" QUELLE = PREP / "SL Schirm" / "SL-Schirm Inhalt.md" ZIEL = PREP / "SL Schirm" / "SL-Schirm (A5 quer).pdf" -FONT_DIR = Path("/usr/share/fonts/truetype/dejavu") +from fontpicker import font_dir # noqa: E402 + +FONT_DIR = font_dir() pdfmetrics.registerFont(TTFont("Serif", str(FONT_DIR / "DejaVuSerif.ttf"))) pdfmetrics.registerFont(TTFont("Serif-Bold", str(FONT_DIR / "DejaVuSerif-Bold.ttf"))) pdfmetrics.registerFont(TTFont("Sans", str(FONT_DIR / "DejaVuSans.ttf"))) diff --git a/tools/build_sl_tabellen.py b/tools/build_sl_tabellen.py index fce9feb..9f16f4e 100644 --- a/tools/build_sl_tabellen.py +++ b/tools/build_sl_tabellen.py @@ -35,7 +35,9 @@ VAULT = ROOT / "RPG" PREP = VAULT / "7-Prep" / "prep_2026-11-20" SRC_ARKAN = VAULT / "3-Welt" / "Geheimnisse" / "Es gibt kein unbegrenztes Zaubern.md" SRC_Klerus = VAULT / "5-Regeln" / "Hausregeln" / "Liturgien und Glaubensgemeinschaften.md" -FONT_DIR = Path("/usr/share/fonts/truetype/dejavu") +from fontpicker import font_dir # noqa: E402 + +FONT_DIR = font_dir() pdfmetrics.registerFont(TTFont("Serif", str(FONT_DIR / "DejaVuSerif.ttf"))) pdfmetrics.registerFont(TTFont("Serif-Bold", str(FONT_DIR / "DejaVuSerif-Bold.ttf"))) diff --git a/tools/build_zauber_almanach.py b/tools/build_zauber_almanach.py index 8ca3eab..9e10d7d 100644 --- a/tools/build_zauber_almanach.py +++ b/tools/build_zauber_almanach.py @@ -41,7 +41,9 @@ VAULT = ROOT / "RPG" PREP = VAULT / "7-Prep" / "prep_2026-11-20" SPELL_DIR = VAULT / "5-Regeln" / "Zauber" / "Arkan" TITLE_IMAGE = PREP / "summarium_titelband.png" -FONT_DIR = Path("/usr/share/fonts/truetype/dejavu") +from fontpicker import font_dir # noqa: E402 + +FONT_DIR = font_dir() # ---------------------------------------------------------------- Schriften pdfmetrics.registerFont(TTFont("Serif", str(FONT_DIR / "DejaVuSerif.ttf"))) diff --git a/tools/fontpicker.py b/tools/fontpicker.py new file mode 100644 index 0000000..a226855 --- /dev/null +++ b/tools/fontpicker.py @@ -0,0 +1,55 @@ +"""Findet das Verzeichnis mit den DejaVu-Schriften – Linux (Desktop) wie macOS. + +Reihenfolge: +1. Umgebungsvariable ``WESTREICHE_FONT_DIR`` (manueller Override), +2. übliche Installationspfade (Linux-Distributionen, Homebrew-Cask auf macOS), +3. Rückfall: Suche per ``fc-list``/``mdfind``-freier Kandidatenliste im Home-Verzeichnis. + +Die PDF-Skripte registrieren ihre Schriften damit unabhängig vom Betriebssystem. +""" + +from __future__ import annotations + +import os +from pathlib import Path + +CANDIDATES = ( + "/usr/share/fonts/truetype/dejavu", # Debian/Ubuntu + "/usr/share/fonts/dejavu", # Fedora/Arch + "/usr/share/fonts/TTF", # Arch + "/usr/local/share/fonts/dejavu", + "/opt/homebrew/share/fonts", # Homebrew (macOS, arm64) + "/usr/local/share/fonts", # Homebrew (macOS, intel) + "~/Library/Fonts", # macOS: `brew install --cask font-dejavu` + "/Library/Fonts", + "/System/Library/Fonts/Supplemental", +) + +NEEDED = ("DejaVuSerif.ttf", "DejaVuSans.ttf") + +HINT = ( + "DejaVu-Schriften nicht gefunden. Installation:\n" + " macOS: brew install --cask font-dejavu\n" + " Debian: sudo apt install fonts-dejavu\n" + " oder: WESTREICHE_FONT_DIR=/pfad/zu/den/ttf exportieren" +) + + +def _enough(path: Path) -> bool: + return all((path / name).is_file() for name in NEEDED) + + +def font_dir() -> Path: + env = os.environ.get("WESTREICHE_FONT_DIR") + if env: + candidate = Path(env).expanduser() + if _enough(candidate): + return candidate + raise SystemExit(f"WESTREICHE_FONT_DIR={env} enthält keine DejaVu-Schriften.\n{HINT}") + + for raw in CANDIDATES: + candidate = Path(raw).expanduser() + if _enough(candidate): + return candidate + + raise SystemExit(HINT) diff --git a/tools/requirements.txt b/tools/requirements.txt new file mode 100644 index 0000000..368168d --- /dev/null +++ b/tools/requirements.txt @@ -0,0 +1,12 @@ +# Python-Abhängigkeiten der Vault-Werkzeuge +# Installation (Repo-Wurzel): +# python3 -m venv .venv +# .venv/bin/pip install -r tools/requirements.txt +# +# Systemwerkzeuge zusätzlich: +# ghostscript (macOS: brew install ghostscript) – A4-Skalierung in den PDF-Builds +# pandoc (macOS: brew install pandoc) – tools/md2odt.sh, tools/make_reference_odt.py +# DejaVu-Fonts (macOS: brew install --cask font-dejavu) – alle reportlab-Builds +reportlab>=4.0 +markdown>=3.4 +pillow>=10.0