Editorial PPTX Deck
Produce una presentación de diapositivas pulida, de estilo editorial-minimalista, y expórtala a un PPTX editable. El entregable final es únicamente el .pptx — las diapositivas HTML son solo la fuente de construcción, y no se producen visualizadores PDF/HTML.
Cómo funciona
Las diapositivas se crean como HTML restringido (un archivo por diapositiva), luego scripts/html2pptx.js traduce cada elemento DOM en un objeto nativo de PowerPoint (cuadros de texto reales, editables con doble clic). El cuerpo se fija en 1280px × 720px = 960pt × 540pt (LAYOUT_WIDE).
Flujo de trabajo de construcción
Copia esta lista de verificación y realiza un seguimiento del progreso:
- [ ] 1. Inicializar proyecto (shared/ assets/ slides/ output/)
- [ ] 2. Planificar la narrativa → asignar cada diapositiva a un tipo de plantilla
- [ ] 3. Escribir slides/NN-nombre.html a partir de las plantillas (solo editar texto)
- [ ] 4. check_overflow → corregir cualquier diapositiva que no mida exactamente 1280x720
- [ ] 5. Exportar PPTX (solo)
- [ ] 6. Limpiar la fuente de construcción (conservar solo el .pptx)
1. Inicializar proyecto. En el proyecto de trabajo, crea shared/, assets/, slides/, output/. Copia shared/tokens.css de esta habilidad al shared/ del proyecto. Copia solo las fotos que usarás de la carpeta assets/ de esta habilidad al assets/ del proyecto. Instala las dependencias una vez:
npm i pptxgenjs playwright sharp && npx playwright install chromium
2. Planificar. Convierte el contenido original en una lista de diapositivas. Cada diapositiva es uno de los tipos de plantilla. Una presentación típica = portada → (divisor → 1–3 diapositivas de contenido) × secciones → cierre. Mantén el texto conciso; este estilo es aireado.
3. Escribir diapositivas. Copia la plantilla más cercana de templates/ a slides/NN-nombre.html y reemplaza el texto. Reglas:
- Mantén
<link rel="stylesheet" href="../shared/tokens.css">. - Los títulos usan la serif; todo lo demás usa sans-serif (ya configurado en tokens).
- Solo un acento rojo. Usa el panel oscuro (
--ink-panel) con moderación para contraste, con el dorado#C9A24Bcomo su único acento. - Las fotos se insertan mediante
<img>(nuncabackground-imageen CSS). Consulta la biblioteca de fotos.
4. Verificar ajuste. Las diapositivas que se desbordan se recortan en PPTX:
node scripts/check_overflow.mjs --slides slides
Corrige cualquier elemento marcado como OVERFLOW (acorta texto o ajusta posiciones) hasta que todo indique 1280x720.
5. Exportar solo PPTX.
node scripts/export_deck_pptx.mjs --slides slides --out output/NombreDeck.pptx
Las diapositivas se ordenan por nombre de archivo (01-…, 02-…). No ejecutes ninguna exportación PDF/HTML — PPTX es el único entregable.
6. Limpiar. Elimina el HTML de slides/ y cualquier archivo temporal para que solo quede output/NombreDeck.pptx (además de shared/ y assets/ reutilizables si el usuario quiere iterar).
Sistema de diseño
Definido en shared/tokens.css. No inventes nuevos colores.
| Token | HEX | Uso |
|---|---|---|
--ink | #1A1A1A | Títulos y cuerpo principal |
--soft | #555555 | Cuerpo secundario |
--muted | #8C8C8C | Etiquetas, notas, números de página |
--red | #C8102E | El único acento: barra, anticipo, palabras clave, subrayados |
--red-deep | #A00C24 | Énfasis negativo en tablas |
--red-pale | #FBE9EC | Fichas de conexión (ej. círculos "→") |
--box | #F4F3F1 | Tarjetas claras / filas de cebra |
--line | #E4E2DE | Separadores finos |
--ink-panel | #1C1C1C | Paneles de contraste oscuro |
| gold | #C9A24B | Acento solo en paneles oscuros |
| background | #FFFFFF | Página |
- Tipografía: Georgia serif para
h*/títulos; Arial/Helvetica sans-serif para todo lo demás. - Firma: barra vertical roja delgada a la izquierda del título + pequeño anticipo rojo con espaciado de letras arriba; número de página pequeño centrado en la parte inferior.
- Cambio de marca: para adaptarse a otra empresa, cambia
--red(y opcionalmente--ink-panel/gold) entokens.css— nada más.
Biblioteca de fotos
Las fotos se encuentran en la carpeta assets/ de esta habilidad. Las imágenes verticales llenan el ~40% derecho del panel divisor/portada (object-fit:cover); las imágenes apaisadas son adecuadas para portadas a sangre completa.
| Archivo | Orientación | Mejor para |
|---|---|---|
sail.png | vertical 589×1024 | divisor / panel derecho de portada (predeterminado) |
lighthouse-cliff.png | vertical 627×1024 | divisor / panel derecho de portada |
staircase.png | alta 312×1024 | tira divisora calmada/abstracta |
mast.png | estrecha 208×1024 | tira divisora estrecha |
hiker-clouds.png | estrecha 225×1024 | tira divisora estrecha |
lighthouse-sunset.png | apaisada 1024×721 | portada a sangre / banda superior |
sailboat-deck.png | apaisada 1024×721 | portada a sangre / banda superior |
Cambia una foto modificando <img src="../assets/….png">. Mantén una foto consistente (o un mismo motivo) en todos los divisores para lograr cohesión. Los usuarios también pueden colocar sus propias imágenes en assets/.
Catálogo de plantillas
En templates/ (cada una es una diapositiva completa de 1280×720, segura contra desbordamientos):
| Archivo | Tipo |
|---|---|
01-cover.html | Portada dividida: título serif a la izquierda, foto vertical a la derecha |
02-divider.html | Divisor de sección: anticipo + título serif + barra roja, foto vertical a la derecha |
03-three-column.html | Anticipo/título + línea central + 3 columnas + franja de resultado |
04-mapping.html | Dos columnas "lo que quieren → lo que hacemos" con fichas de conexión |
05-compare-table.html | Tabla comparativa de 3 columnas, filas de cebra |
06-dark-contrast.html | Dos paneles (claro vs oscuro) + línea de pie serif |
07-pipeline.html | Pipeline horizontal numerado de pasos + barra de salida oscura |
08-closing.html | Cierre: líneas serif numeradas + foto vertical a la derecha |
Restricciones estrictas
La conversión HTML→PPTX falla o se renderiza incorrectamente si se infringen estas reglas. Detalles completos y soluciones en reference.md:
- El texto solo dentro de
<p>/<h1>–<h6>(nunca texto suelto en un<div>). - Sin degradados CSS.
background/border/box-shadowsolo en<div>, nunca en etiquetas de texto.- No usar
background-image; usar<img>. - Las etiquetas en línea (
span/em/strong) no pueden tener márgenes. - El cuerpo se mantiene en 1280×720; nada puede desbordarse.
