Système de Conception de Présentations PDF & de Visualisation de Données Vérifiables
Ce skill fonctionne de pair avec verifiable-pdf-pipeline (intégrité des données) et editorial-page-layout-guidelines (géométrie de grille) pour produire des décks exécutifs 16:9 sombres et des rapports institutionnels au format Lettre, ivoire suisse clair, inspirés par McKinsey, Stripe Press, le WEF et The Economist.
1. Invariant Fondamental : Le Fond Prime sur l'Esthétique
Chaque présentation ou rapport créé avec ce skill doit obéir aux 10 Règles Anti-Triche définies dans verifiable-pdf-pipeline/SKILL.md :
- Coupure d'Air Zéro-Données-Manuscrites — analyser tous les nombres à partir de fichiers bruts immuables dans
data/raw/. - Compilateur de Réalité & d'Invariants — appliquer des bornes de domaine Pydantic et des identités comptables.
- Vérification Anti-Circulaire — recalcul indépendant depuis les fichiers bruts + vérification AST Python interdisant les assertions littérales codées en dur.
- Registre de Provenance Atomique — chaque scalaire publié est mappé 1:1 dans
data/provenance_ledger.json. - Capacité Négative & le Sacré « N/A » — les valeurs nulles amont authentiques sont rendues explicitement comme
[N/A]plutôt que par des proxies fabriqués. - Verrou de Compilation — les compilateurs PDF invoquent
verify_integrity.pyet abandonnent sur un code de sortie non nul. - Garde de Catégorie & d'Unité — ne jamais mélanger des périmètres ou des méthodes de test incommensurables.
- Preuve Légale — les identifiants officiels des gazettes sont requis pour toute affirmation réglementaire ou tarifaire.
- Taxonomie Scientifique & Vérification de Registre — concilier binômes, autorités, phylogénie et statut UICN textuellement aux registres vivants GBIF/OpenTree/iNaturalist.
- Ancrage de la Prose Post-Rendu (
vedit prose) — chaque chiffre rendu dans le PDF final retrace jusqu'àprovenance_ledger.json,summary_metrics.jsonou une entrée indexée DOI dansbackground_citations.json.
2. Les 4 Lois d'Or du Design
Loi 1 : La Hiérarchie Colorimétrique 60-30-10 (Modes Clair & Sombre)
- Mode Éditorial Suisse Clair (Rapports Lettre) :
60%Toile : Ivoire Chaud Suisse (#fcfbf9) — peinte explicitement viaonPage.30%Échafaudage : Bleu Marine Profond (#0f2b48), Ardoise (#334155), Acier (#64748b), Filets (#cbd5e1), Teinte Subtile (#f1f5f9).10%Accent de Signal : Cobalt (#0284c7), Ambre (#d97706), Émeraude (#059669), Carmin de Signal (#dc2626— risque/surcharge uniquement).
- Mode Exécutif Sombre (Décks 16:9) :
60%Toile : Obsidienne Profonde (#0b0f19) ou Bleu Nuit Minuit (#051c2c) — DOIT être peinte en plein écran dansonFirstPage/onLaterPagesAVANT que les éléments fluides ne soient rendus, sans jamais compter sur le papier blanc par défaut du PDF !30%Échafaudage & Texte à Fort Contraste : Bande Tonal Subtile (#111827/#0a253a), Filets (#243247), Titres Blanc Pur (#ffffff), Corps Clair et Net (>= #e2e8f0à>= 9.5–10 pt), Légendes Secondaires (>= #cbd5e1, jamais de prose#64748b–#94a3b8sur fond sombre). Toujours placer un scrim horizontal sombre subtil derrière la typographie de couverture lorsque des ondes paramétriques filaires ou des illustrations vives se trouvent près du texte.10%Accent de Signal : Cobalt Électrique (#38bdf8), Ambre Vif (#fbbf24), Émeraude (#34d399), Carmin de Signal (#f87171).
Loi 2 : Filets & Gravité des Espaces Blancs (Zéro Cartes Encadrées)
- Ne jamais enfermer de métriques ou de prose dans des traits
BOXrectangulaires lourds ou desINNERGRIDde tableaux de bord web. - Grouper les KPI et les appels via des bandes tonales sans bordure (
#111827sombre /#f1f5f9clair) surmontées d'un filet d'accent supérieur net de1.2 pt, avec des gouttières de colonnes généreuses de12–16 ptet des ledgers Tufte de style booktabs (zéro ligne verticale).
Loi 3 : Titres d'Action de la Pyramide Minto
Chaque diapositive ou section de rapport s'ouvre sur une affirmation complète et assertive, et non sur une étiquette de sujet passive :
- Interdit :
« Tendances mondiales des émissions » - Requis :
« Les pays de l'OCDE-5 ont réduit leurs émissions de -25.0 %, tandis que les Émergents-3 ont bondi de +235.8 %, faisant grimper les totaux du panel à 23.52 Gt CO2e. »
Loi 4 : Budgets de Remplissage Vertical Calibrés + Inspection Visuelle
- Rapports Lettre (
612×792 pt) : Remplissage vertical cible85%–92%(min >= 82%). - Décks 16:9 (
960×540 pt) : Remplissage vertical cible72%–88%(min >= 72%). - Ne jamais considérer un passage automatisé comme le dernier mot : exporter des aperçus PNG 180 DPI via
audit_pdf.pyet inspecter visuellement chaque page rendue pour détecter les chevauchements d'étiquettes, les veuves dans les titres et l'équilibre optique.
3. Recettes de Visualisation de Données Institutionnelles (300 DPI, Transparent)
Rendre tous les graphiques avec dpi=300, transparent=True, les épines supérieure et droite supprimées, et des palettes adaptées au thème (dark vs light) :
- Série Temporelle Double Panneau + Accélération du Taux : Trajectoire historique mensuelle/quotidienne avec ombrage des événements et annotations directes de début/pic, associée à des barres de taux décennal/période.
- Aire Empilée de Bilan Massique + Trajectoire Indexée : Volumes de flux empilés avec étiquettes terminales directes sur le bord droit (zéro boîte de légende flottante séparée !) associés à des lignes de divergence structurelle
Base = 100. - Nuage de Points du Quadrant de Découplage + Compression Haltère : Nuage 2D croissance-vs-résultat avec quadrant cible ombré + flèches de leader pour les clusters denses, associé à des haltères horizontaux base-à-actuel.
- Graphiques à Balles Horizontaux de Stephen Few : 3 bandes de fond qualitatives + barre de performance primaire + coche de cible verticale ambre/de base + texte delta aligné à droite (axe x réduit avec
ax.spines["bottom"].set_bounds(...)). - Sparklines Tufte Sourdes en Mémoire : Micro-lignes de
46–66 pt × 13–16 ptrendues dans des tamponsio.BytesIO()et intégrées directement dans les cellules des tableaux ReportLab avec des points terminaux sémantiques émeraude/carmin. - Heatmap de Matrice Origine-Destination & KDE Ridgeline : Palette séquentielle avec typographie double à contraste commuté ou crêtes de distribution superposées marquant les $P_{50}$ et $P_{90}$.
4. Patrons de Mise en Œuvre ReportLab de Production
4.1 Peinture de Toile en Plein Écran (Crucial pour les Thèmes Sombres & Ivoire)
Toujours enregistrer un callback onPage pour que le fond de la toile soit peint sous chaque élément fluide sur chaque page :
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 Découverte Sûre de la Police TTF Inter avec Repli Propre
Ne jamais coder en dur "Inter-SemiBold" sans enregistrer d'abord le TTF — utiliser une fonction auxiliaire qui vérifie INTER_FONT_DIR et les chemins de polices standard du système d'exploitation et se replie proprement sur Helvetica :
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 En-têtes Courants à Deux Passes & Foliotage Dynamique
Utiliser une sous-classe de reportlab.pdfgen.canvas.Canvas qui sauvegarde les dictionnaires d'état de page dans showPage() et imprime "Page X de Y" ou "Diapositive X / Y" dans save() (voir examples/reportlab_premium_template.py).
5. Mode Consulting 2023 Flagship (WeasyPrint + SVG Vectoriel Pur Intégré)
Pour des décks de niveau keynote modelés sur les publications institutionnelles phares de 2023 (Quantum Technology Monitor, The Economic Potential of Generative AI, Global Economics Intelligence, The State of Organizations), associer WeasyPrint (@page { size: 960pt 540pt; margin: 0; }) avec des exposés <svg> vectoriels purs 100 % intégrés :
- Cadence de Polarité Héroïque-Sombre / Données-Blanches-Pures (Jamais Monotone) :
- Héroïque de Couverture : Bleu Nuit Minuit Profond (
#051C2C) transitionnant vers le Cobalt (#0A2E8A), superposé d'une onde de Bézier hyperbolique paramétrique à 42 brins (#2251FF/#00A9F4) et d'une illustration éditoriale propre sur la droite. - Résumé Exécutif :
#051C2Cen plein écran, titre à empattement blanc net de28 ptau-dessus d'une règle horizontale blanche de1.2 pt, 3 colonnes aérées sans empattement et 3 grands KPI à empattement cyan/bleu. - Séparateurs de Chapitre en Deux Parties : Haut
48%en plein écran avec illustration lumineuse ancrée par un chiffre à empattement blanc gras de120 pt(1,2), bas52%blanc pur avec titre de chapitre à empattement en retrait de220 ptà gauche et copie de cadrage sur 2 colonnes. - Diapositives d'Exposé de Données : Toile
#FFFFFFpure, titre d'action à empattement gras de19.5–22 ptau-dessus d'une règle#051C2Cde1.1 pt, séparateur de note de bas de page subtil, et pilule de progression de section cyan glacé#9AE6FFen bas à droite.
- Héroïque de Couverture : Bleu Nuit Minuit Profond (
- Association Empattement Éditorial à Fort Contraste + Sans Empattement Géométrique :
- Empattement d'Affichage (
Charter/Georgia/BaskervilleGras) : Titres de couverture, chiffres de section, titres d'action de diapositive, grands appels KPI#2251FFde54 ptet totaux centrés du donut. - Sans Empattement de Données (
Inter/Helvetica Neue) : Annotations de graphiques, sous-titres, cellules de ledgers, notes de bas de page et copie d'implications.
- Empattement d'Affichage (
- La Rampe Chromatique Bleue McKinsey à 4 Niveaux (Zéro Encombrement Arc-en-Ciel) :
#051C2CBleu Nuit Minuit (totaux d'ancrage, baselines, contractions profondes) →#06319CBleu Royal Profond →#2251FFBleu Électrique (deltas focaux, grands KPI, poussées d'expansion) →#00A9F4Cyan Vif →#9AE6FFCyan Glacé (parts secondaires et pilules de section).
- Archétypes d'Exposés SVG Vectoriels Signature :
- Graphique en Cascade / Pont de Bilan Massique : Barres d'ancrage (
#051C2C), ajouts flottants (#2251FF) et réductions (#00A9F4), connecteurs de pas en pointillés, appels de portée en parenthèses supérieures et delta net flottant à empattement. - Mur de Petits Multiples + Barre Latérale d'Implications Gris
»: Cartes de trajectoire indexée groupées5 + 3associées à une barre latérale#EFEFEFà droite reliée par un badge chevron»circulaire#051C2C(anneau blanc3 pt). - Matrice de Gaufrette Unitée Carrée-Ronde 10×10 : Grilles
10×10remplies de bas en haut (piste#E5E7EB, remplissage bleu à 4 niveaux) avec des chiffres gras centrés dans l'espace négatif gris. - Anneau Donut + Changement de Part Empilé à 100 % : Donut bleu en 5 étapes (séparateurs de tranche blancs
2 px, total central à empattement) associé à des colonnes2000vs2024reliées par des rubans de flux translucides. - Garde-fous SVG WeasyPrint : Dans les conteneurs flex, toujours donner aux
<svg>intégrés unewidth/heightexplicite enpt(et définir.slide { height: 539.5pt; break-after: page; break-inside: avoid; }) pour éviter les pages de déversement blanches sous-pixel ou l'effondrement SVG à300 px. Ne jamais utiliser SVG 2paint-order="stroke"sur<text>dans WeasyPrint (il trace par-dessus le remplissage du texte) ; utiliser des décalages d'étiquette propres ou un<rect>d'arrière-plan explicite à la place.
- Graphique en Cascade / Pont de Bilan Massique : Barres d'ancrage (
- Mode Magazine Photo Éditorial en Plein Écran (
612 × 792 ptLettre Portrait, WeasyPrint) : Lors de la production de magazines éditoriaux photo-first (style Kinfolk × Cereal × Condé Nast Traveler × National Geographic, comme démontré dansdemos/felis-mundi-magazine/) :- Typographie & Papier : Associer du papier non couché chaud d'archives (
#FAF8F5) et de l'encre charbon de bois carbon profond (#161616) avec des empattements d'affichage Didone à fort contraste (Didot/Bodoni 72), un corps de texte chaud à empattement livre (Charter/Baskervilleà9 pt, interlignage1.5×), et des métadonnées sans empattement en majuscules largement espacées (Inter,6.5–7 pt, suivi+0.18em). Retourner sans couture les folios courants et les crédits en#FFFFFFpur sur la photo en plein écran. - Photographie Cohésive (
>= 50%de Fond Perdu Bord à Bord) : Générer chaque planche sous un Noyau d'Identité Film Photographique Maître verrouillé (voirreferences/image_generation_recipes.md§5), varier l'architecture de la double page sur les pages adjacentes (couverture 100% → fond perdu haut 61% → colonne verticale droite 65% → essai photo 100% → diptyque 76% avec gouttières d'impression blanches4 pt→ fond perdu bas 68% → triptyque de planche contact 77% → colophon 100% de crépuscule de fermeture), et créditer la photographie IA de manière transparente aux côtés d'un manifeste de planche SHA-256. - Garde-fous WeasyPrint Magazine (Vérifiés Empiriquement) :
- Lettres Ornées (
float: left) : Ne jamais placer une lettre ornéefloat: leftà l'intérieur d'un élément CSS Grid ou Flexbox dans WeasyPrint 67.0 (cela rétrécit la colonne de texte ou désaligne/heurte la lettre ornée). Utiliser des colonnes de blocsposition: absolute(display: block) pour les pages de magazine fractionnées afin que les lettres ornées soient 100 % alignées à gauche avec un retour à la ligne propre multi-lignes. - Scrims de Dégradé Sans Couture : Ne jamais placer une boîte de superposition
linear-gradientde hauteur partielle sur un ciel ou une neige brillants dans WeasyPrint (Cairo peint une fine couture de 1 px le long du bord de la boîte). Toujours dimensionner chaque superposition de scrim à100%de son conteneur photo et fondre versrgba(..., 0)à l'intérieur des arrêts transparents. - Crédits Marginaux Rotatifs : Ancrer les crédits verticaux sur le bord droit avec
top: 18pt; right: 16pt; transform-origin: 100% 0%; transform:
- Lettres Ornées (
- Typographie & Papier : Associer du papier non couché chaud d'archives (
...
[le contenu original a été tronqué pour la traduction]