Communitygithub.com

diseño-premium-pdf

Sistema de diseño institucional para presentaciones PDF (16:9 decks ejecutivos oscuros) e informes (carta, marfil suizo claro). Aplica tuberías de datos abiertos verificables, balance de color 60-30-10, contabilidad Tufte, títulos de acción Minto, visualización vectorial a 300 DPI, registro seguro de fuente Inter, pintado a sangre completa y auditoría visual automatizada con PyMuPDF.

¿Qué es diseño-premium-pdf?

Esta habilidad es un sistema integral para crear presentaciones PDF e informes institucionales de grado profesional, inspirado en firmas como McKinsey, Stripe Press, WEF y *The Economist*. Soporta dos modos principales: decks ejecutivos oscuros en formato 16:9 (960×540 pt) e informes editoriales claros en formato Carta (612×792 pt). Su núcleo se basa en cuatro leyes de diseño: jerarquía de color 60-30-0, líneas finas Tufte con abundante espacio en blanco, títulos de acción Minto y presupuestos de llenado vertical calibrados. Además, integra reglas rigurosas de integridad de datos, como el aislamiento de datos escritos a mano, verificación con invariantes Pydantic, y un libro de procedencia atómico. La implementación utiliza ReportLab para el pintado a sangre completa y WeasyPrint para gráficos SVG vectoriales puros, ofreciendo recetas de visualización de datos como series temporales, gráficos de área apilados, gráficos de viñetas Stephen Few y matrices de origen-destino. Incluye patrones para registro seguro de la fuente Inter, cabeceras dinámicas y auditoría visual a través de capturas PNG a 180 DPI.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Sistema Verificable de Presentación PDF Institucional y Visualización de Datos

Esta habilidad se complementa con verifiable-pdf-pipeline (integridad de datos) y editorial-page-layout-guidelines (geometría de cuadrícula) para producir decks ejecutivos oscuros 16:9 e informes institucionales claros en formato Carta con marfil suizo inspirados en McKinsey, Stripe Press, WEF y The Economist.


1. Invariante Central: La Sustancia Antecede a la Estética

Toda presentación o informe construido con esta habilidad debe obedecer las 10 Reglas Estrictas Antifraude definidas en verifiable-pdf-pipeline/SKILL.md:

  1. Aislamiento de Datos Escritos a Mano — analizar todos los números de archivos inmutables en data/raw/.
  2. Compilador de Realidad e Invariantes — aplicar límites de dominio Pydantic e identidades contables.
  3. Verificación Anticircular — recálculo independiente de archivos fuente + verificación AST de Python que prohíbe aserciones literales codificadas.
  4. Libro de Procedencia Atómica — cada escalar publicado mapeado 1:1 en data/provenance_ledger.json.
  5. Capacidad Negativa y el Sagrado "N/A" — los valores nulos legítimos aguas arriba se renderizan explícitamente como [N/A] en lugar de proxies inventados.
  6. Bloqueo de Compilación — los compiladores PDF invocan verify_integrity.py y abortan si la salida no es cero.
  7. Protección de Categoría y Unidad — nunca mezclar alcances o métodos de prueba inconmensurables.
  8. Prueba Legal — se requieren IDs de gaceta oficial para cualquier afirmación regulatoria o arancelaria.
  9. Taxonomía Científica y Verificación de Registro — reconciliar nombres binomiales, autoridades, filogenia y estado de la UICN textualmente contra registros en vivo de GBIF/OpenTree/iNaturalist.
  10. Fundamentación de Prosa Posterior al Renderizado (vedit prose) — cada número renderizado en el PDF final se remonta a provenance_ledger.json, summary_metrics.json, o una entrada respaldada por DOI en background_citations.json.

2. Las 4 Leyes de Diseño de Oro

Ley 1: La Jerarquía de Color 60-30-10 (Modos Claro y Oscuro)

  • Modo Editorial Claro Suizo (Informes Carta):
    • 60% Lienzo: Marfil Cálido Suizo (#fcfbf9) — pintado explícitamente vía onPage.
    • 30% Andamiaje: Azul Marino Profundo (#0f2b48), Pizarra (#334155), Acero (#64748b), Líneas Finas (#cbd5e1), Tinte Sutil (#f1f5f9).
    • 10% Acento de Señal: Cobalto (#0284c7), Ámbar (#d97706), Esmeralda (#059669), Rojo Carmesí (#dc2626 — solo riesgo/aumento).
  • Modo Ejecutivo Oscuro (Decks 16:9):
    • 60% Lienzo: Obsidiana Profunda (#0b0f19) o Azul Medianoche (#051c2c) — DEBE pintarse a sangre completa en onFirstPage/onLaterPages ANTES de que se rendericen los flowables, ¡sin depender nunca del papel blanco predeterminado del PDF!
    • 30% Andamiaje y Texto de Alto Contraste: Banda Tonal Sutil (#111827 / #0a253a), Líneas Finas (#243247), Títulos Blancos Puros (#ffffff), Cuerpo Claro Nítido (>= #e2e8f0 a >= 9.5–10 pt), Leyendas Secundarias (>= #cbd5e1, nunca prosa atenuada #64748b–#94a3b8 sobre fondo oscuro). Colocar siempre un scrim oscuro horizontal sutil detrás de la tipografía de portada cuando ondas paramétricas de alambre o ilustraciones brillantes estén cerca del texto.
    • 10% Acento de Señal: Cobalto Eléctrico (#38bdf8), Ámbar Brillante (#fbbf24), Esmeralda (#34d399), Rojo Carmesí (#f87171).

Ley 2: Línea Fina y Gravedad del Espacio en Blanco (Cero Tarjetas con Cajas)

  • Nunca encerrar métricas o prosa dentro de trazos pesados de CUADRO rectangulares o CUADRICULA_INTERNA de paneles web.
  • Agrupar KPI y llamadas mediante bandas tonales sin bordes (#111827 oscuro / #f1f5f9 claro) coronadas con una línea fina de acento superior de 1.2 pt, generosos márgenes de columna de 12–16 pt, y contabilidad estilo booktabs Tufte (cero líneas verticales).

Ley 3: Títulos de Acción Minto

Cada diapositiva o sección del informe se abre con una afirmación completa y asertiva, no una etiqueta de tema pasiva:

  • Prohibido: "Tendencias Globales de Emisiones"
  • Requerido: "Los Países de la OCDE Redujeron Emisiones -25.0%, Mientras que los Emergentes-3 Aumentaron +235.8% Elevando los Totales del Panel a 23.52 Gt CO2e."

Ley 4: Presupuestos de Llenado Vertical Calibrados + Inspección Visual

  • Informes Carta (612×792 pt): 85%–92% de llenado vertical objetivo (mín >= 82%).
  • Decks 16:9 (960×540 pt): 72%–88% de llenado vertical objetivo (mín >= 72%).
  • Nunca tratar una verificación automatizada como la palabra final: exportar vistas previas PNG a 180 DPI mediante audit_pdf.py e inspeccionar visualmente cada página renderizada para detectar superposiciones de etiquetas, viudas en títulos y equilibrio óptico.

3. Recetas de Visualización de Datos Institucionales (300 DPI, Transparente)

Renderizar todos los gráficos con dpi=300, transparent=True, ejes superior y derecho eliminados, y paletas temáticas (oscuro vs claro):

  1. Serie Temporal de Doble Panel + Tasa de Aceleración: Trayectoria histórica mensual/diaria con sombreado de eventos y anotaciones directas de inicio/pico combinadas con barras de tasa decenal/período.
  2. Área Apilada de Balance Másico + Trayectoria Indexada: Volúmenes de flujo apilados con etiquetas terminales directas en el borde derecho (¡sin cuadros de leyenda flotantes separados!) combinados con líneas de divergencia estructural Base = 100.
  3. Dispersión de Cuadrante de Desacoplamiento + Compresión con Pesas: Dispersión 2D de crecimiento vs resultado con cuadrante objetivo sombreado + flechas de líder para grupos densos, combinado con pesas horizontales de línea base a actual.
  4. Gráficos de Viñetas Horizontales Stephen Few: 3 bandas de fondo cualitativas + barra de rendimiento principal + marca vertical ámbar de línea base/objetivo + texto delta alineado a la derecha (eje x recortado usando ax.spines["bottom"].set_bounds(...)).
  5. Sparklines Tufte sin Cabecera en Memoria: Microlíneas de 46–66 pt × 13–16 pt renderizadas en buffers io.BytesIO() e incrustadas directamente dentro de celdas de tabla de ReportLab con puntos terminales semánticos esmeralda/carmesí.
  6. Mapa de Calor Matriz Origen-Destino y KDEs de Cresta: Paleta secuencial con tipografía dual de contraste conmutado o crestas de superposición superpuestas marcando $P_{50}$ y $P_{90}$.

4. Patrones de Implementación de ReportLab de Producción

4.1 Pintado de Lienzo a Sangre Completa (Crítico para Temas Oscuros y Marfil)

Registrar siempre un callback onPage para que el fondo del lienzo pinte debajo de cada flowable en cada página:

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 Descubrimiento Seguro de Inter TTF con Retroceso Limpio

Nunca codificar "Inter-SemiBold" sin registrar primero la TTF, usar un ayudante que verifique INTER_FONT_DIR y rutas de fuente estándar del SO y retroceda limpiamente a 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 Encabezados Corrientes de Dos Pasos y Folio Dinámico

Usar una subclase de reportlab.pdfgen.canvas.Canvas que guarde diccionarios de estado de página en showPage() y estampe "Página X de Y" o "Diapositiva X / Y" en save() (ver examples/reportlab_premium_template.py).


5. Modo Insignia de Consultoría 2023 (WeasyPrint + SVG Vectorial Puro En Línea)

Para decks de nivel clave modelados según publicaciones institucionales insignia de 2023 (Quantum Technology Monitor, The Economic Potential of Generative AI, Global Economics Intelligence, The State of Organizations), combinar WeasyPrint (@page { size: 960pt 540pt; margin: 0; }) con exposiciones <svg> en línea 100% puramente vectoriales:

  1. Cadencia de Polaridad Héroe Oscuro / Datos Blanco Puro (Nunca Monótono):
    • Portada Héroe: Azul Medianoche Profundo (#051C2C) con transición a Cobalto (#0A2E8A), superpuesto con una onda de alambre Bezier hiperbólica paramétrica de 42 hebras (#2251FF / #00A9F4) e ilustración héroe editorial limpia a la derecha.
    • Resumen Ejecutivo: Fondo a sangre completa #051C2C, titular serifa blanco nítido de 28 pt sobre una regla horizontal blanca de 1.2 pt, 3 columnas aireadas sans, y 3 KPI serifa gigantes cian/azul.
    • Divisores de Capítulo Divididos: Superior 48% ilustración luminosa a sangre completa anclada por un número serifa blanco negrita de 120 pt (1, 2), inferior 52% blanco puro con titular de capítulo serifa de 220 pt con sangría izquierda y texto de marco de 2 columnas.
    • Diapositivas de Exposición de Datos: Lienzo blanco puro #FFFFFF, título de acción serifa negrita de 19.5–22 pt sobre una regla #051C2C de 1.1 pt, separador de nota al pie sutil inferior, y una píldora de progreso de sección cian hielo #9AE6FF en la esquina inferior derecha.
  2. Combinación de Serifa Editorial de Alto Contraste + Sans Geométrica:
    • Serifa de Pantalla (Charter / Georgia / Baskerville Negrita): Títulos de portada, números de sección, títulos de acción de diapositiva, KPI gigantes #2251FF de 54 pt, y totales de anillo central.
    • Sans de Datos (Inter / Helvetica Neue): Anotaciones de gráficos, subtítulos, celdas de contabilidad, notas al pie y texto de implicaciones.
  3. La Rampa Cromática Azul McKinsey de 4 Niveles (Cero Desorden de Arcoíris):
    • #051C2C Azul Medianoche (anclas de totales, líneas base, contracciones profundas) → #06319C Azul Real Profundo → #2251FF Azul Eléctrico (deltas focales, KPI gigantes, aumentos de expansión) → #00A9F4 Cian Vívido → #9AE6FF Cian Hielo (participaciones secundarias y píldoras de sección).
  4. Arquetipos de Exposición SVG Vectorial Característicos:
    • Gráfico de Cascada / Puente de Balance Másico: Barras de anclaje (#051C2C), adiciones flotantes (#2251FF) y reducciones (#00A9F4), conectores de paso discontinuos, llamadas de tramo de corchete superior, y delta neto serifa flotante.
    • Muro de Múltiples Pequeños + Barra Lateral de Implicaciones Gris »: Tarjetas de trayectoria indexada agrupadas 5 + 3 combinadas con una barra lateral #EFEFEF a la derecha unida por una insignia de cheurón » #051C2C circular (anillo blanco de 3 pt).
    • Matriz Unidad Waffle de Cuadrado Redondeado 10×10: Cuadrículas 10×10 llenadas de abajo arriba (#E5E7EB pista, relleno azul de 4 niveles) con números negrita centrados dentro del espacio negativo gris.
    • Anillo Donut + Cambio de Participación Apilada al 100%: Donut azul de 5 pasos (divisores de porción blancos de 2 px, total central serifa) combinado con columnas 2000 vs 2024 unidas por cintas de flujo translúcidas.
    • Salvaguardas SVG de WeasyPrint: Dentro de contenedores flex, siempre dar a <svg> en línea width/height explícito en pt (y establecer .slide { height: 539.5pt; break-after: page; break-inside: avoid; }) para evitar páginas en blanco de subpíxel o colapso de SVG a 300 px. Nunca usar SVG 2 paint-order="stroke" en <text> en WeasyPrint (dibuja el trazo sobre el relleno del texto); usar compensaciones de etiqueta limpias o un <rect> de fondo explícito en su lugar.
  5. Modo Revista de Fotos Editorial a Sangre Completa (612 × 792 pt Carta Retrato, WeasyPrint): Al producir revistas editoriales centradas en fotografía (estilo Kinfolk × Cereal × Condé Nast Traveler × National Geographic, como se demuestra en demos/felis-mundi-magazine/):
    • Tipografía y Papel: Combinar papel de archivo no estucado cálido (#FAF8F5) y tinta de carbón vegetal profunda (#161616) con serifas de pantalla Didone de alto contraste (Didot / Bodoni 72), texto de cuerpo serifa cálido (Charter / Baskerville a 9 pt, interlineado 1.5×), y metadatos sans mayúsculas con espaciado amplio (Inter, 6.5–7 pt, tracking +0.18em). Voltear folios y créditos corrientes sin problemas a blanco puro #FFFFFF sobre fotografía a sangre completa.
    • Fotografía Cohesiva (>= 50% de Sangrado de Borde a Borde): Generar cada placa bajo un Núcleo de Identidad de Película Fotográfica Maestra bloqueado (ver references/image_generation_recipes.md §5), variar la arquitectura de pliegue entre páginas adyacentes (100% portada → 61% sangrado superior → 65% columna vertical derecha → 100% ensayo fotográfico → 76% díptico con márgenes de impresión blancos de 4 pt → 68% sangrado inferior → 77% tríptico de hoja de contactos → 100% colofón de anochecer de cierre), y acreditar la fotografía de IA de manera transparente junto con un manifiesto de placa SHA-256.
    • Salvaguardas de Revista WeasyPrint (Verificadas Empíricamente):
      • Letras Capitales (float: left): Nunca colocar una letra capital float: left dentro de un elemento CSS Grid o Flexbox en WeasyPrint 67.0 (reduce la columna de texto o desalinea/colisiona la letra capital). Usar columnas de bloque position: absolute (display: block) para páginas de revista divididas para que las letras capitales se asienten 100% alineadas a la izquierda con ajuste de línea limpio.
      • Máscaras Degradadas Sin Costuras: Nunca colocar un cuadro de superposición de degradado lineal de altura parcial sobre cielo brillante o nieve en WeasyPrint (Cairo pinta una costura tenue de 1 px a lo largo del borde del cuadro). Siempre dimensionar cada superposición de máscara al 100% de su contenedor de foto y desvanecer a rgba(..., 0) dentro de las paradas transparentes.
      • Créditos Marginales Rotados: Anclar créditos verticales en el borde derecho con top: 18pt; right: 16pt; transform-origin: 100% 0%; transform: rotate(90deg); en WeasyPrint para evitar desbordamiento o colapso.

6. Tubería de Auditoría de Control de Calidad

Cada PDF debe ser auditado automáticamente con audit_pdf.py:

python audit_pdf.py --input output/report.pdf --dpi 180 --check-fill 0.85 --check-bleed

El script:

  • Exporta cada página como PNG a 180 DPI para inspección visual.
  • Verifica la cobertura de pintado de lienzo (sin páginas blancas predeterminadas).
  • Mide el porcentaje de llenado vertical real (pyMuPDF o pdfplumber).
  • Detecta superposiciones de texto mediante comprobaciones de intersección de cuadros delimitadores.

La compilación final falla si:

  • verify_integrity.py sale con código distinto de cero.
  • audit_pdf.py informa < 82% de llenado vertical (informes) o < 72% (decks).

7. Integración de WeasyPrint para Modo Insignia

Para el modo insignia de consultoría, construir filas de exposición SVG en línea y envolverlas en WeasyPrint:

<!DOCTYPE html>
<html>
<head>
<style>
  @page { size: 960pt 540pt; margin: 0; }
  .slide { height: 539.5pt; page-break-after: always; page-break-inside: avoid; overflow: hidden; }
</style>
</head>
<body>
  <div class="slide">
    <svg width="960pt" height="540pt" viewBox="0 0 960 540">
      <!-- exposición vectorial pura -->
    </svg>
  </div>
</body>
</html>

Ejecutar: weasyprint slide.html output/slide.pdf.


Ver también

  • Guía completa de modos: references/design_modes.md
  • Recetas de generación de imágenes: references/image_generation_recipes.md
  • Proyectos de demostración: demos/
  • Plantilla base de ReportLab: examples/reportlab_premium_template.py
  • Tubería de integridad de datos: verifiable-pdf-pipeline/

Individual skills in this repo

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

Skills relacionados