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:
- Aislamiento de Datos Escritos a Mano — analizar todos los números de archivos inmutables en
data/raw/. - Compilador de Realidad e Invariantes — aplicar límites de dominio Pydantic e identidades contables.
- Verificación Anticircular — recálculo independiente de archivos fuente + verificación AST de Python que prohíbe aserciones literales codificadas.
- Libro de Procedencia Atómica — cada escalar publicado mapeado 1:1 en
data/provenance_ledger.json. - 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. - Bloqueo de Compilación — los compiladores PDF invocan
verify_integrity.pyy abortan si la salida no es cero. - Protección de Categoría y Unidad — nunca mezclar alcances o métodos de prueba inconmensurables.
- Prueba Legal — se requieren IDs de gaceta oficial para cualquier afirmación regulatoria o arancelaria.
- 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.
- Fundamentación de Prosa Posterior al Renderizado (
vedit prose) — cada número renderizado en el PDF final se remonta aprovenance_ledger.json,summary_metrics.json, o una entrada respaldada por DOI enbackground_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íaonPage.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 enonFirstPage/onLaterPagesANTES 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 (>= #e2e8f0a>= 9.5–10 pt), Leyendas Secundarias (>= #cbd5e1, nunca prosa atenuada#64748b–#94a3b8sobre 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
CUADROrectangulares oCUADRICULA_INTERNAde paneles web. - Agrupar KPI y llamadas mediante bandas tonales sin bordes (
#111827oscuro /#f1f5f9claro) coronadas con una línea fina de acento superior de1.2 pt, generosos márgenes de columna de12–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.pye 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):
- 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.
- Á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. - 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.
- 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(...)). - Sparklines Tufte sin Cabecera en Memoria: Microlíneas de
46–66 pt × 13–16 ptrenderizadas en buffersio.BytesIO()e incrustadas directamente dentro de celdas de tabla de ReportLab con puntos terminales semánticos esmeralda/carmesí. - 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:
- 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 de28 ptsobre una regla horizontal blanca de1.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 de120 pt(1,2), inferior52%blanco puro con titular de capítulo serifa de220 ptcon 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 de19.5–22 ptsobre una regla#051C2Cde1.1 pt, separador de nota al pie sutil inferior, y una píldora de progreso de sección cian hielo#9AE6FFen la esquina inferior derecha.
- Portada Héroe: Azul Medianoche Profundo (
- Combinación de Serifa Editorial de Alto Contraste + Sans Geométrica:
- Serifa de Pantalla (
Charter/Georgia/BaskervilleNegrita): Títulos de portada, números de sección, títulos de acción de diapositiva, KPI gigantes#2251FFde54 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.
- Serifa de Pantalla (
- La Rampa Cromática Azul McKinsey de 4 Niveles (Cero Desorden de Arcoíris):
#051C2CAzul Medianoche (anclas de totales, líneas base, contracciones profundas) →#06319CAzul Real Profundo →#2251FFAzul Eléctrico (deltas focales, KPI gigantes, aumentos de expansión) →#00A9F4Cian Vívido →#9AE6FFCian Hielo (participaciones secundarias y píldoras de sección).
- 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 agrupadas5 + 3combinadas con una barra lateral#EFEFEFa la derecha unida por una insignia de cheurón»#051C2Ccircular (anillo blanco de 3 pt). - Matriz Unidad Waffle de Cuadrado Redondeado 10×10: Cuadrículas
10×10llenadas de abajo arriba (#E5E7EBpista, 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 columnas2000vs2024unidas por cintas de flujo translúcidas. - Salvaguardas SVG de WeasyPrint: Dentro de contenedores flex, siempre dar a
<svg>en líneawidth/heightexplícito enpt(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 a300 px. Nunca usar SVG 2paint-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.
- Gráfico de Cascada / Puente de Balance Másico: Barras de anclaje (
- Modo Revista de Fotos Editorial a Sangre Completa (
612 × 792 ptCarta Retrato, WeasyPrint): Al producir revistas editoriales centradas en fotografía (estilo Kinfolk × Cereal × Condé Nast Traveler × National Geographic, como se demuestra endemos/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/Baskervillea9 pt, interlineado1.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#FFFFFFsobre 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 (verreferences/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 de4 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 capitalfloat: leftdentro 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 bloqueposition: 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 argba(..., 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.
- Letras Capitales (
- Tipografía y Papel: Combinar papel de archivo no estucado cálido (
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 (
pyMuPDFopdfplumber). - Detecta superposiciones de texto mediante comprobaciones de intersección de cuadros delimitadores.
La compilación final falla si:
verify_integrity.pysale con código distinto de cero.audit_pdf.pyinforma < 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/