Überprüfbares institutionelles PDF-Präsentations- und Datenvisualisierungssystem
Dieses Skill arbeitet mit verifiable-pdf-pipeline (Datenintegrität) und editorial-page-layout-guidelines (Rastergeometrie) zusammen, um publikationsreife 16:9 dunkle Executive-Foliensätze und Letter helle Swiss-Ivory-Institutionsberichte zu erstellen, inspiriert von McKinsey, Stripe Press, WEF und The Economist.
1. Kerninvariante: Substanz vor Ästhetik
Jede mit diesem Skill erstellte Präsentation oder jeder Bericht muss die 10 Anti-Cheat-Hard-Regeln aus verifiable-pdf-pipeline/SKILL.md befolgen:
- Null-Luftspalt bei handgeschriebenen Daten – Alle Zahlen aus unveränderlichen Rohdateien in
data/raw/parsen. - Realitäts- und Invarianten-Compiler – Pydantic-Domänengrenzen und Buchhaltungsidentitäten durchsetzen.
- Anti-zirkuläre Verifikation – Unabhängige Neuberechnung der Rohdatei + Python-AST-Prüfung, die hartcodierte literale Assertions verbietet.
- Atomares Herkunftsverzeichnis – Jeder veröffentlichte Skalar wird 1:1 in
data/provenance_ledger.jsonabgebildet. - Negative Fähigkeit und das heilige „N/A“ – Echte upstream-Nullen werden explizit als
[N/A]dargestellt, nicht als erfundene Platzhalter. - Kompilationssperre – PDF-Compiler rufen
verify_integrity.pyauf und brechen bei einem Exit-Code ungleich Null ab. - Kategorie- und Einheitenwächter – Niemals inkommensurable Bereiche oder Testmethoden vermischen.
- Gesetzlicher Nachweis – Offizielle Amtsblatt-IDs für regulatorische oder tarifliche Behauptungen erforderlich.
- Wissenschaftliche Taxonomie- und Registerverifikation – Binominale, Autoritäten, Phylogenie und IUCN-Status wörtlich gegen aktuelle GBIF/OpenTree/iNaturalist-Register abgleichen.
- Nach-Rendering-Prosa-Grundierung (
vedit prose) – Jede gerenderte Zahl im endgültigen PDF führt zurück zuprovenance_ledger.json,summary_metrics.jsonoder einem DOI-gestützten Eintrag inbackground_citations.json.
2. Die 4 goldenen Designgesetze
Gesetz 1: Die 60-30-10-Farbhierarchie (helle und dunkle Modi)
- Heller Schweizer Redaktionsmodus (Letter-Berichte):
60%Leinwand: Swiss Warm Ivory (#fcfbf9) – explizit überonPagegemalt.30%Gerüst: Deep Navy (#0f2b48), Slate (#334155), Steel (#64748b), Hairlines (#cbd5e1), Subtle Tint (#f1f5f9).10%Signalakzent: Cobalt (#0284c7), Amber (#d97706), Emerald (#059669), Signal Crimson (#dc2626– nur Risiko/Anstieg).
- Dunkler Executive-Modus (16:9 Foliensätze):
60%Leinwand: Deep Obsidian (#0b0f19) oder Midnight Navy (#051c2c) – MUSS randlos inonFirstPage/onLaterPagesVOR dem Rendern von Flowables gemalt werden, niemals auf das standardmäßige weiße PDF-Papier verlassen!30%Gerüst und kontrastreicher Text: Subtle Tonal Band (#111827/#0a253a), Hairlines (#243247), Pure White Titles (#ffffff), Crisp Light Body (>= #e2e8f0bei>= 9.5–10 pt), Secondary Captions (>= #cbd5e1, niemals#64748b–#94a3b8Prosa auf dunklem Hintergrund dimmen). Platziere immer einen subtilen horizontalen dunklen Scrim hinter der Cover-Typografie, wenn parametrische Drahtgitterwellen oder helle Kunstwerke in der Nähe von Text sitzen.10%Signalakzent: Electric Cobalt (#38bdf8), Bright Amber (#fbbf24), Emerald (#34d399), Signal Crimson (#f87171).
Gesetz 2: Haardünne Linien und Weißraum-Schwerkraft (Null Box-Karten)
- Niemals Metriken oder Prosa in schwere rechteckige
BOX-Striche oderINNERGRID-Web-Dashboard-Boxen einsperren. - KPIs und Callouts über rahmenlose tonale Bänder (
#111827dunkel /#f1f5f9hell) gruppieren, gekrönt mit einer knackigen1.2 ptoberen Akzent-Haarlinie, großzügigen12–16 ptSpaltenabständen und Booktabs-artigen Tufte-Ledgern (null vertikale Linien).
Gesetz 3: Minto-Pyramiden-Aktionstitel
Jede Folie oder jeder Berichtsabschnitt beginnt mit einer vollständigen, assertiven Behauptung, nicht mit einem passiven Themenetikett:
- Verboten:
„Globale Emissionstrends“ - Erforderlich:
„OECD-5 senkte Emissionen um -25,0 %, doch Emerging-3 stieg um +235,8 % und hob die Panel-Summen auf 23,52 Gt CO2e.“
Gesetz 4: Kalibrierte vertikale Füllbudgets + visuelle Inspektion
- Letter-Berichte (
612×792 pt):85%–92%Ziel vertikale Füllung (min >= 82%). - 16:9 Decks (
960×540 pt):72%–88%Ziel vertikale Füllung (min >= 72%). - Behandle einen automatischen Durchlauf niemals als endgültiges Wort: Exportiere 180-DPI-PNG-Vorschauen via
audit_pdf.pyund überprüfe jede gerenderte Seite visuell auf Label-Überlappungen, Witwen-Überschriftenumbrüche und optische Balance.
3. Institutionelle Datenvisualisierungsrezepte (300 DPI, Transparent)
Rendere alle Diagramme mit dpi=300, transparent=True, entfernten oberen/rechten Achsenspinen und themenangepassten Paletten (dunkel vs hell):
- Zweifach-Zeitreihe + Ratenbeschleunigung: Historische monatliche/tägliche Trajektorie mit Ereignisschattierung und direkten Start/Peak-Annotationen, gepaart mit dekadischen/periodischen Ratenbalken.
- Gestapeltes Massenbilanz-Flächendiagramm + Indizierte Trajektorie: Gestapelte Flussvolumina mit direkten rechten Rand-Endlabels (keine separaten schwebenden Legendenboxen!), gepaart mit
Basis = 100strukturellen Divergenzlinien. - Entkopplungs-Streudiagramm im Quadranten + Hantelkompression: 2D-Wachstums-vs-Ergebnis-Streudiagramm mit schattiertem Zielquadranten + Führungspfeilen für enge Cluster, gepaart mit horizontalen Hanteln von Basislinie zu aktuell.
- Stephen Few horizontale Bullet-Graphen: 3 qualitative Hintergrundbänder + primärer Leistungsbalken + vertikaler Zielstrich (Amber-Baseline/Target) + rechtsbündiger Delta-Text (beschnittene x-Achsen-Spine mittels
ax.spines["bottom"].set_bounds(...)). - Kopflose Tufte-Sparklines im Arbeitsspeicher:
46–66 pt × 13–16 ptMikrolinien, die inio.BytesIO()-Puffer gerendert und direkt in ReportLab-Tabellenzellen eingebettet werden, mit semantischen Smaragd-/Karmin-Endpunkten. - Ursprungs-Ziel-Matrix-Heatmap + Ridgeline-KDEs: Sequentielle Palette mit kontrastgeschalteter dualer Typografie oder überlappenden Verteilungskämmen, die $P_{50}$ und $P_{90}$ markieren.
4. Produktions-ReportLab-Implementierungsmuster
4.1 Randlose Canvas-Malerei (Kritisch für dunkle und Elfenbeinfarbene Themen)
Registriere immer einen onPage-Callback, damit der Canvas-Hintergrund unter jedem Flowable auf jeder Seite malt:
from reportlab.lib import colors
def paint_background(canv, _doc, bg_hex="#0b0f19", accent_hex="#38bdf8", page_w=960.0, page_h=540.0):
canv.saveState()
canv.setFillColor(colors.HexColor(bg_hex))
canv.rect(0, 0, page_w, page_h, fill=1, stroke=0)
if canv.getPageNumber() == 1:
canv.setFillColor(colors.HexColor(accent_hex))
canv.rect(0, page_h - 4, page_w, 4, fill=1, stroke=0)
canv.restoreState()
4.2 Sichere Inter-TTF-Erkennung mit sauberem Fallback
Hartcodiere niemals "Inter-SemiBold" ohne vorherige TTF-Registrierung – verwende eine Hilfsfunktion, die INTER_FONT_DIR und standardmäßige OS-Schriftpfade prüft und sauber auf Helvetica zurückfällt:
import os
from pathlib import Path
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont
def register_editorial_fonts() -> dict[str, str]:
search = [Path(os.environ["INTER_FONT_DIR"])] if os.environ.get("INTER_FONT_DIR") else []
search += [Path.home() / "Library/Fonts", Path("/Library/Fonts"), Path("/usr/share/fonts/truetype/inter")]
files = {"regular": "Inter-Regular.ttf", "semibold": "Inter-SemiBold.ttf",
"bold": "Inter-Bold.ttf", "italic": "Inter-Italic.ttf", "bold_italic": "Inter-BoldItalic.ttf"}
found = {r: d / f for d in search if d.is_dir() for r, f in files.items() if (d / f).is_file()}
if {"regular", "bold", "italic", "bold_italic"}.issubset(found):
for role, name in [("regular", "Inter-Regular"), ("bold", "Inter-Bold"),
("italic", "Inter-Italic"), ("bold_italic", "Inter-BoldItalic")]:
pdfmetrics.registerFont(TTFont(name, str(found[role])))
semi = "Inter-Bold"
if "semibold" in found:
pdfmetrics.registerFont(TTFont("Inter-SemiBold", str(found["semibold"])))
semi = "Inter-SemiBold"
pdfmetrics.registerFontFamily("Inter-Regular", normal="Inter-Regular", bold="Inter-Bold",
italic="Inter-Italic", boldItalic="Inter-BoldItalic")
return {"regular": "Inter-Regular", "semibold": semi, "bold": "Inter-Bold",
"italic": "Inter-Italic", "bold_italic": "Inter-BoldItalic", "mono": "Courier"}
return {"regular": "Helvetica", "semibold": "Helvetica-Bold", "bold": "Helvetica-Bold",
"italic": "Helvetica-Oblique", "bold_italic": "Helvetica-BoldOblique", "mono": "Courier"}
4.3 Zwei-Durchlauf-Laufköpfe und dynamische Seitenzahlen
Verwende eine Unterklasse von reportlab.pdfgen.canvas.Canvas, die Seitenzustandsdiktate in showPage() speichert und "Seite X von Y" oder "Folie X / Y" in save() einprägt (siehe examples/reportlab_premium_template.py).
5. 2023-Consulting-Flaggschiff-Modus (WeasyPrint + reine Vektor-Inline-SVG)
Für Keynote-würdige Decks, die auf Flaggschiff-Institutionspublikationen von 2023 modelliert sind (Quantum Technology Monitor, The Economic Potential of Generative AI, Global Economics Intelligence, The State of Organizations), kombiniere WeasyPrint (@page { size: 960pt 540pt; margin: 0; }) mit 100 % reinen Vektor-Inline-<svg>-Exponaten:
- Dunkel-Held / Rein-Weiß-Daten-Polaritäts-Kadenz (Niemals eintönig):
- Cover-Held: Deep Midnight Navy (
#051C2C) übergehend in Cobalt (#0A2E8A), überlagert mit einer 42-strängigen parametrischen hyperbolischen Bezier-Drahtgitterwelle (#2251FF/#00A9F4) und sauberer redaktioneller Heldenkunst auf der rechten Seite. - Executive Summary: Randloses
#051C2C, knappe28 ptweiße Serifen-Überschrift über einem1.2 ptweißen horizontalen Strich, 3 luftige serifenlose Spalten und 3 riesige cyan/blaue Serifen-KPIs. - Geteilte Kapiteltrenner: Obere
48 %randlose leuchtende Kunst, verankert durch eine120 ptfette weiße Serifenziffer (1,2), untere52 %reines Weiß mit220 ptlinks eingerückter Serifen-Kapitelüberschrift und 2-spaltigem Rahmenkopier. - Datendiagramm-Folien: Reine
#FFFFFF-Leinwand,19.5–22 ptfette Serifen-Aktionstitel über einem1.1 pt#051C2C-Strich, subtiler unterer Fußnotentrenner und eine unten rechts#9AE6FFeis-cyan Abschnittsfortschrittspille.
- Cover-Held: Deep Midnight Navy (
- Kontrastreiche redaktionelle Serifen- + geometrische Serifenlosen-Paarung:
- Anzeige-Serife (
Charter/Georgia/BaskervilleBold): Cover-Titel, Abschnittszahlen, Folien-Aktionstitel, riesige54 pt#2251FF-KPI-Callouts und zentrierte Donut-Gesamtsummen. - Daten-Serifenlose (
Inter/Helvetica Neue): Diagrammannotationen, Untertitel, Ledger-Zellen, Fußnoten und Implikationskopien.
- Anzeige-Serife (
- Die 4-stufige McKinsey-Blau-Chromatik-Rampe (Null Regenbogen-Unordnung):
#051C2CMidnight Navy (Ankersummen, Basislinien, tiefe Kontraktionen) →#06319CDeep Royal →#2251FFElectric Blue (fokale Deltas, riesige KPIs, Expansionsschübe) →#00A9F4Vivid Cyan →#9AE6FFIce Cyan (sekundäre Anteile und Abschnittspillen).
- Charakteristische Vektor-SVG-Exponat-Archetypen:
- Massenbilanz-Wasserfall / Brückendiagramm: Ankerbalken (
#051C2C), schwebende Additionen (#2251FF) und Reduktionen (#00A9F4), gestrichelte Schrittverbinder, obere eckige Klammer-Span-Callouts und schwebendes Serifen-Netto-Delta. - Small-Multiples-Wand + graue
»-Implikationsseitenleiste: Gruppierte5 + 3indizierte Trajektorienkarten, gepaart mit einer rechten#EFEFEF-Seitenleiste, verbunden durch ein kreisförmiges#051C2C-»-Chevron-Abzeichen (3 ptweißer Ring). - 10×10 abgerundetes-Quadrat-Waffel-Einheitsmatrix: Von unten nach oben gefüllte
10×10-Gitter (#E5E7EB-Spur, 4-stufige blaue Füllung) mit zentrierten fetten Ziffern im grauen Negativraum. - Donut-Ring + 100 % gestapelte Anteilsverschiebung: 5-stufiger blauer Donut (
2 pxweiße Scheibentrenner, Serifen-Zentrumssumme) gepaart mit2000vs.2024-Spalten, verbunden durch durchscheinende Flussbänder. - WeasyPrint-SVG-Leitplanken: Gib Inline-
<svg>innerhalb von Flex-Containern immer explizitewidth/heightinpt(und setze.slide { height: 539.5pt; break-after: page; break-inside: avoid; }), um Subpixel-Leerseiten oder300 px-SVG-Kollaps zu vermeiden. Verwende niemals SVG 2paint-order="stroke"auf<text>in WeasyPrint (es zeichnet über der Textfüllung); verwende saubere Label-Offsets oder ein explizites<rect>im Hintergrund.
- Massenbilanz-Wasserfall / Brückendiagramm: Ankerbalken (
- Randloser redaktioneller Fotografie-Magazin-Modus (
612 × 792 ptLetter Hochformat, WeasyPrint): Bei der Produktion fotografieorientierter redaktioneller Magazine (Stil Kinfolk × Cereal × Condé Nast Traveler × National Geographic, wie indemos/felis-mundi-magazine/demonstriert):- Typografie und Papierqualität: Kombiniere warmes unbeschichtetes Archivpapier (
#FAF8F5) und tiefe Kohlenstoff-Kohle-Tinte (#161616) mit kontrastreichen Didone-Anzeige-Serifen (Didot/Bodoni 72), warmer Buch-Serifen-Fließtext (Charter/Baskervillebei9 pt,1.5×Zeilenabstand) und weit gespurten Großbuchstaben-Metadaten (Inter,6.5–7 pt,+0.18emTracking). Wechsle laufende Kolumnentitel und Bildnachweise nahtlos zu reinem#FFFFFFüber randlosen Fotos. - Kohärente Fotografie (
>= 50 %randloser Rand): Erstelle jede Tafel unter einem gesperrten Master-Fotografischen Film-Identitätskern (siehereferences/image_generation_recipes.md§5), variiere die Ausbreitungsarchitektur über benachbarte Seiten hinweg (100 % Cover → 61 % oberer Rand → 65 % rechte vertikale Spalte → 100 % Fotoessay → 76 % Diptychon mit4 ptweißen Druckrinnen → 68 % unterer Rand → 77 % Kontaktabzug-Triptychon → 100 % abschließende Dämmerungskolophon) und kreditiere KI-Fotografie transparent zusammen mit einem SHA-256-Plattenmanifest. - WeasyPrint-Magazin-Leitplanken (empirisch verifiziert):
- Initialen (
float: left): Platziere niemals einefloat: left-Initiale innerhalb eines CSS-Grid- oder Flexbox-Elements in WeasyPrint 67.0 (sie schrumpft die Textspalte oder versetzt/kollidiert die Initiale). Verwendeposition: absolute-Block-Spalten (display: block) für geteilte Magazinseiten, damit Initialen 100 % bündig links mit sauberem mehrzeiligen Umbruch sitzen. - Nahtlose Farbverlaufsscrims: Platziere niemals eine teilhöhe
linear-gradient-Überlagerungsbox über hellem Himmel oder Schnee in WeasyPrint (Cairo malt eine schwache 1 px Haarlinien-Naht entlang der Boxkante). Dimensioniere immer jeden Scrim-Overlay auf100 %seines Fotocontainers und blende zurgba(..., 0)innerhalb der transparenten Stopps aus. - Rotierte Rand-Bildnachweise: Verankere vertikale rechte Rand-Bildnachweise mit
top: 18pt; right: 16pt; transform-origin: 100% 0%; transform: rotate(180deg); writing-mode: vertical-rl;für zuverlässige Ausrichtung (statttransform: rotate(90deg);), um konsistentes bündiges rechts/Rand- und Blätterverhalten in WeasyPrint zu gewährleisten.
- Initialen (
- Typografie und Papierqualität: Kombiniere warmes unbeschichtetes Archivpapier (