Communitygithub.com

premium-pdf-design

Système de conception de présentations PDF institutionnelles (décks exécutifs 16:9 sombres) et de rapports (format Lettre, ivoire suisse clair). Applique des pipelines de données vérifiables, un équilibre colorimétrique 60-30-10, des filets Tufte, des titres d'action Minto, des visualisations vectorielles 300 DPI, une police Inter sécurisée, un fond perdu intégral et un audit visuel automatisé via PyMuPDF.

Qu'est-ce que premium-pdf-design ?

Le skill **premium-pdf-design** fournit un système de conception complet pour générer des présentations PDF et des rapports de qualité institutionnelle, respectant des normes rigoureuses de vérité des données et d'esthétique de design. Il s'appuie sur un ensemble de 10 règles anti-triche (héritées du pipeline `verifiable-pdf-pipeline`) garantissant que chaque chiffre provient de sources de données immuables et vérifiables. Le skill impose quatre lois de conception fondamentales : une hiérarchie de couleurs 60-30-10 adaptée aux modes clair et sombre, l'utilisation de filets Tufte et d'espaces blancs généreux (sans boîtes lourdes), des titres d'action selon le principe de la Pyramide Minto, et des budgets de remplissage vertical calibrés. Il est compatible avec les frameworks **ReportLab** et **WeasyPrint**. Pour ReportLab, le skill fournit des patrons concrets comme la peinture de fond en plein écran, l'enregistrement sécurisé de la police Inter avec repli, et les en-têtes courants à deux passes. Pour WeasyPrint, il détaille une mode 'consulting 2023' avec des exposants SVG vectoriels purs, des palettes de couleurs bleues à 4 niveaux et des architectures de page complexes. Le skill inclut aussi des recettes de visualisation de données institutionnelles (séries temporelles, graphiques à puces de Stephen Few, sparklines Tufte) et des garde-fous spécifiques pour éviter les artefacts de rendu (pages blanches, problèmes de grille CSS, traits de couture dans les dégradés).

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gke0op/verifiable-editorial-skills/tree/HEAD/skills/premium-pdf-design

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 :

  1. Coupure d'Air Zéro-Données-Manuscrites — analyser tous les nombres à partir de fichiers bruts immuables dans data/raw/.
  2. Compilateur de Réalité & d'Invariants — appliquer des bornes de domaine Pydantic et des identités comptables.
  3. Vérification Anti-Circulaire — recalcul indépendant depuis les fichiers bruts + vérification AST Python interdisant les assertions littérales codées en dur.
  4. Registre de Provenance Atomique — chaque scalaire publié est mappé 1:1 dans data/provenance_ledger.json.
  5. 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.
  6. Verrou de Compilation — les compilateurs PDF invoquent verify_integrity.py et abandonnent sur un code de sortie non nul.
  7. Garde de Catégorie & d'Unité — ne jamais mélanger des périmètres ou des méthodes de test incommensurables.
  8. Preuve Légale — les identifiants officiels des gazettes sont requis pour toute affirmation réglementaire ou tarifaire.
  9. Taxonomie Scientifique & Vérification de Registre — concilier binômes, autorités, phylogénie et statut UICN textuellement aux registres vivants GBIF/OpenTree/iNaturalist.
  10. Ancrage de la Prose Post-Rendu (vedit prose) — chaque chiffre rendu dans le PDF final retrace jusqu'à provenance_ledger.json, summary_metrics.json ou une entrée indexée DOI dans background_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 via onPage.
    • 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 dans onFirstPage/onLaterPages AVANT 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–#94a3b8 sur 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 BOX rectangulaires lourds ou des INNERGRID de tableaux de bord web.
  • Grouper les KPI et les appels via des bandes tonales sans bordure (#111827 sombre / #f1f5f9 clair) surmontées d'un filet d'accent supérieur net de 1.2 pt , avec des gouttières de colonnes généreuses de 12–16 pt et 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 cible 85%–92% (min >= 82%).
  • Décks 16:9 (960×540 pt) : Remplissage vertical cible 72%–88% (min >= 72%).
  • Ne jamais considérer un passage automatisé comme le dernier mot : exporter des aperçus PNG 180 DPI via audit_pdf.py et 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) :

  1. 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.
  2. 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.
  3. 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.
  4. 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(...)).
  5. Sparklines Tufte Sourdes en Mémoire : Micro-lignes de 46–66 pt × 13–16 pt rendues dans des tampons io.BytesIO() et intégrées directement dans les cellules des tableaux ReportLab avec des points terminaux sémantiques émeraude/carmin.
  6. 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 :

  1. 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 : #051C2C en plein écran, titre à empattement blanc net de 28 pt au-dessus d'une règle horizontale blanche de 1.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 de 120 pt (1, 2), bas 52% blanc pur avec titre de chapitre à empattement en retrait de 220 pt à gauche et copie de cadrage sur 2 colonnes.
    • Diapositives d'Exposé de Données : Toile #FFFFFF pure, titre d'action à empattement gras de 19.5–22 pt au-dessus d'une règle #051C2C de 1.1 pt, séparateur de note de bas de page subtil, et pilule de progression de section cyan glacé #9AE6FF en bas à droite.
  2. Association Empattement Éditorial à Fort Contraste + Sans Empattement Géométrique :
    • Empattement d'Affichage (Charter / Georgia / Baskerville Gras) : Titres de couverture, chiffres de section, titres d'action de diapositive, grands appels KPI #2251FF de 54 pt et 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.
  3. La Rampe Chromatique Bleue McKinsey à 4 Niveaux (Zéro Encombrement Arc-en-Ciel) :
    • #051C2C Bleu Nuit Minuit (totaux d'ancrage, baselines, contractions profondes) → #06319C Bleu Royal Profond → #2251FF Bleu Électrique (deltas focaux, grands KPI, poussées d'expansion) → #00A9F4 Cyan Vif → #9AE6FF Cyan Glacé (parts secondaires et pilules de section).
  4. 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ées 5 + 3 associées à une barre latérale #EFEFEF à droite reliée par un badge chevron » circulaire #051C2C (anneau blanc 3 pt).
    • Matrice de Gaufrette Unitée Carrée-Ronde 10×10 : Grilles 10×10 remplies 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 colonnes 2000 vs 2024 reliées par des rubans de flux translucides.
    • Garde-fous SVG WeasyPrint : Dans les conteneurs flex, toujours donner aux <svg> intégrés une width/height explicite en pt (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 2 paint-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.
  5. Mode Magazine Photo Éditorial en Plein Écran (612 × 792 pt Lettre Portrait, WeasyPrint) : Lors de la production de magazines éditoriaux photo-first (style Kinfolk × Cereal × Condé Nast Traveler × National Geographic, comme démontré dans demos/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, interlignage 1.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 #FFFFFF pur 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é (voir references/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 blanches 4 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ée float: 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 blocs position: 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-gradient de 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 vers rgba(..., 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:

...

[le contenu original a été tronqué pour la traduction]

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés