ailessonio/open-source-skills

PDF-Fähigkeit

Wann verwenden

• PDF-Inhalte lesen oder überprüfen, wenn Layout und visuelle Darstellung wichtig sind.
• PDFs programmatisch mit zuverlässiger Formatierung erstellen.
• Endgültige Darstellung vor der Auslieferung validieren.

Arbeitsablauf

1. Visuelle Überprüfung bevorzugen: PDF-Seiten in PNGs rendern und inspizieren.
   • pdftoppm verwenden, falls verfügbar.
   • Falls nicht verfügbar, Poppler installieren oder den Benutzer bitten, die Ausgabe lokal zu überprüfen.
2. reportlab verwenden, um PDFs zu generieren, wenn neue Dokumente erstellt werden.
3. pdfplumber (oder pypdf) für Textextraktion und schnelle Prüfungen verwenden; nicht auf Layouttreue verlassen.
4. Nach jeder relevanten Aktualisierung Seiten neu rendern und Ausrichtung, Abstände und Lesbarkeit überprüfen.

Temporäre- und Ausgabekonventionen

• tmp/pdfs/ für Zwischendateien verwenden; nach Abschluss löschen.
• Endgültige Artefakte unter output/pdf/ ablegen, wenn in diesem Repository gearbeitet wird.
• Dateinamen stabil und beschreibend halten.

Abhängigkeiten (installieren, falls fehlend)

uv für die Abhängigkeitsverwaltung bevorzugen.

Python-Pakete:

uv pip install reportlab pdfplumber pypdf

Falls uv nicht verfügbar:

python3 -m pip install reportlab pdfplumber pypdf

Systemwerkzeuge (für das Rendern):

# macOS (Homebrew)
brew install poppler

# Ubuntu/Debian
sudo apt-get install -y poppler-utils

Wenn die Installation in dieser Umgebung nicht möglich ist, dem Benutzer mitteilen, welche Abhängigkeit fehlt und wie sie lokal installiert werden kann.

Umgebung

Keine erforderlichen Umgebungsvariablen.

Rendering-Befehl

pdftoppm -png $INPUT_PDF $OUTPUT_PREFIX

Qualitätserwartungen

• Gepflegtes visuelles Design: konsistente Typografie, Abstände, Ränder und Abschnittshierarchie.
• Rendering-Probleme vermeiden: abgeschnittener Text, überlappende Elemente, defekte Tabellen, schwarze Kästchen oder unleserliche Zeichen.
• Diagramme, Tabellen und Bilder müssen scharf, ausgerichtet und klar beschriftet sein.
• Nur ASCII-Bindestriche verwenden. U+2011 (geschützter Bindestrich) und andere Unicode-Striche vermeiden.
• Zitate und Referenzen müssen für Menschen lesbar sein; niemals Tool-Token oder Platzhalterzeichen hinterlassen.

Abschließende Prüfungen

• Erst ausliefern, wenn die neueste PNG-Inspektion keine visuellen oder Formatierungsfehler zeigt.
• Kopf-/Fußzeilen, Seitenzahlen und Abschnittsübergänge auf poliertes Aussehen prüfen.
• Zwischendateien organisiert halten oder nach der endgültigen Genehmigung entfernen.