pptx

Creación, edición y análisis de PPTX

Un .pptx es un archivo ZIP de archivos XML. Elige tu enfoque según la tarea:

Tarea	Enfoque
Crear una nueva presentación	Escribe un script de pptxgenjs — consulta las advertencias a continuación
Editar una presentación existente, o construir a partir de una plantilla	descomprimir → editar ppt/slides/slideN.xml → comprimir
Leer contenido	markitdown deck.pptx (un bloque por diapositiva bajo los marcadores <!-- Slide number: N -->); cuadrícula visual: python scripts/thumbnail.py deck.pptx

Scripts

Las rutas son relativas al directorio de esta habilidad. Todo lo demás es Python, node o shell simples.

Script	Qué hace
scripts/thumbnail.py deck.pptx [prefijo]	Cuadrícula etiquetada de cada diapositiva, para elegir diseños de plantilla. Solo .pptx. Pasa prefijo — por defecto es thumbnails, que sobrescribe las cuadrículas de cualquier otra presentación en el mismo directorio
scripts/add_slide.py descomprimido/ slide2.xml [--after slideN.xml]	Duplica una diapositiva (o un slideLayoutN.xml) con todo el papeleo del paquete. También acepta un .pptx directamente con -o out.pptx
scripts/clean.py descomprimido/	Elimina diapositivas, medios y relaciones que ya no se referencian. Ejecútalo después de que <p:sldIdLst> esté final
scripts/office/validate.py deck.pptx [--original src.pptx]	Verificaciones de esquema, relaciones, tipos de contenido, gráficos y diapositivas; cada fallo nombra su solución. Pasa --original para cualquier presentación derivada de una plantilla — establece una línea base de las verificaciones de esquema contra la plantilla, para que los errores XSD propios de la plantilla no se lean como tuyos
scripts/office/soffice.py --headless --convert-to pdf deck.pptx	Envoltorio de LibreOffice — soffice desnudo se cuelga en este entorno aislado

Crear con pptxgenjs — advertencias

pptxgenjs está preinstalado — no ejecutes npm install primero; escribe el script y usa require('pptxgenjs') directamente. Solo si ese require falla: npm install pptxgenjs. El modelo conoce la API; estos son los peligros:

• Establece pres.layout antes de agregar diapositivas. El lienzo predeterminado es LAYOUT_16x9 = 10" × 5.625", no 13.3" de ancho. Las coordenadas más allá del borde se escriben, no se recortan — la forma simplemente no está en la diapositiva. (LAYOUT_WIDE es 13.3" × 7.5".)
• Colores hexadecimales: nunca #, nunca 8 dígitos. color: "FF0000". Tanto "#FF0000" como el alfa incluido en el hex ("00000020") corrompen el archivo. Para transparencia: transparency: 0-100 en rellenos e imágenes, opacity: 0.0-1.0 en sombras — cada uno se ignora silenciosamente en el otro.
• pptxgenjs muta los objetos de opciones en su lugar (convierte valores a EMU en el primer uso). Nunca compartas un mismo objeto shadow/opciones entre dos llamadas add* — construye un objeto nuevo cada vez.
• La offset de sombra debe ser ≥ 0 — un desplazamiento negativo corrompe el archivo. Para proyectar una sombra hacia arriba, usa angle: 270 con un desplazamiento positivo.
• letterSpacing se ignora silenciosamente — la opción real es charSpacing.
• Listas: bullet: true en cada elemento, nunca un • literal (representa viñetas dobles). Establece breakLine: true en cada elemento del arreglo excepto el último. Espacia los párrafos con viñetas con paraSpaceAfter, no con lineSpacing (grandes espacios).
• Un new pptxgen() por archivo de salida — nunca reutilices una instancia.
• rectRadius solo funciona en ROUNDED_RECTANGLE, no en RECTANGLE.
• Los rellenos degradados no son compatibles — usa una imagen degradada como fondo en su lugar.
• Los cuadros de texto tienen relleno interno incorporado — establece margin: 0 cada vez que el texto deba alinearse con una forma, línea o icono en la misma x.
• Las notas del orador van en slide.addNotes("...") (texto plano, una vez por diapositiva), nunca en un cuadro de texto en la diapositiva.
• Mantén los gráficos nativos. Usa addChart() para todo lo que PowerPoint puede graficar (pasa un arreglo de {type, data, options} para combinaciones). Para funciones nativas de PowerPoint que la biblioteca no expone (líneas de tendencia, barras de error), calcula las series adicionales tú mismo o procesa posteriormente el OOXML generado — no recurras a una imagen renderizada. Solo los tipos de gráficos para los que PowerPoint no tiene una forma nativa (Sankey, red, acorde) van como imágenes.
• Los gráficos predeterminados se renderizan desnudos — sin título, sin etiquetas de datos, paleta anticuada. Establece showTitle + title, showValue: true + dataLabelPosition, chartColors: [...] de tu paleta, y silencia el marco (catAxisLabelColor/valAxisLabelColor, valGridLine: { color, size }, catGridLine: { style: "none" }, showLegend: false para una sola serie).
• En un gráfico de barras o columnas apilado, dataLabelPosition debe ser ctr, inEnd o inBase. outEnd corrompe el archivo.
• Una serie combinada que usa secondaryValAxis/secondaryCatAxis necesita tanto valAxes como catAxes en las opciones del gráfico, dos entradas cada uno. Sin ellos, pptxgenjs escribe ids de ejes que nunca declara, y PowerPoint descarta ese gráfico e informa el archivo como corrupto. Proporcionar solo valAxes no es suficiente.
• Después de writeFile(), ejecuta python scripts/office/validate.py deck.pptx. Informa los dos fallos de gráficos anteriores y los defectos de XML de diapositivas que PowerPoint rechaza, y nombra la solución para cada uno. Corrígelos en tu generador, no editando manualmente el XML empaquetado.
• Nunca reordenes los hijos de <p:presentation>. pptxgenjs escribe <p:notesMasterIdLst> justo después de <p:sldIdLst> y apunta ambos patrones a una parte de tema. PowerPoint lo lee felizmente — mueve el elemento y la misma presentación se vuelve imposible de abrir.
• Iconos: renderiza react-icons a SVG (ReactDOMServer.renderToStaticMarkup), rasteriza con sharp a ≥256px, e inserta mediante addImage({ data: "image/png;base64," + buf.toString("base64") }) — el prefijo image/png;base64, es obligatorio (react-icons, react, react-dom y sharp están preinstalados — npm install react-icons react react-dom sharp solo si un require falla).

Editar presentaciones y plantillas existentes

Elige primero los diseños: python scripts/thumbnail.py plantilla.pptx plantilla-thumbs escribe una cuadrícula etiquetada de cada diapositiva e imprime el(los) archivo(s) que creó — plantilla-thumbs.jpg, dividido en plantilla-thumbs-N.jpg después de 12 diapositivas. Siempre pasa ese segundo argumento, nombrado según la presentación. Por defecto es thumbnails, así que dos presentaciones en miniatura en un mismo directorio sobrescriben silenciosamente las cuadrículas de la otra — las de la primera presentación simplemente se pierden (solo análisis de plantilla — la revisión visual necesita los renders de resolución completa de Conversión a imágenes; solo acepta .pptx, así que copia primero un .potx a un nombre .pptx). Úsalo con markitdown para mapear cada sección de contenido a una diapositiva de plantilla y varía los diseños — no pongas cada sección en la misma diapositiva de título y viñetas.

python3 -c "import sys,zipfile; zipfile.ZipFile(sys.argv[1]).extractall('descomprimido')" presentacion.pptx
python scripts/add_slide.py descomprimido/ slide2.xml --after slide2.xml   # duplica una diapositiva (o slideLayoutN.xml); imprime la ruta de la nueva diapositiva
# reordenar / eliminar diapositivas = editar <p:sldIdLst> en ppt/presentation.xml
python scripts/clean.py descomprimido/                                     # después de eliminaciones: elimina diapositivas, medios, relaciones huérfanas
# editar el contenido de la diapositiva en ppt/slides/slideN.xml
(cd descomprimido && rm -f ../out.pptx && zip -Xr ../out.pptx .)           # comprimir DESDE DENTRO del directorio; rm primero o las partes eliminadas sobreviven
python scripts/office/validate.py out.pptx --original presentacion.pptx

• Haz todo el trabajo estructural — agregar, eliminar, reordenar — antes de editar el contenido de cualquier diapositiva. add_slide.py copia un archivo de diapositiva textualmente, así que duplicar después de editar clona el contenido editado; y clean.py elimina cualquier diapositiva que falte en <p:sldIdLst>, incluida una que acabas de escribir.
• Nunca copies un archivo de diapositiva manualmente — add_slide.py hace todos los registros que necesita una nueva diapositiva e informa lo que creó (Created ppt/slides/slide17.xml from slide2.xml). También funciona directamente en un archivo: add_slide.py presentacion.pptx slide2.xml -o out.pptx — pasa -o, o sobrescribe la presentación de entrada en su lugar. Una diapositiva duplicada todavía hace referencia a las partes de gráfico/SmartArt/objeto incrustado de su fuente en lugar de clonarlas, así que editar el gráfico de una diapositiva cambia el de la otra.
• Si usas python-pptx, tres cosas que no hará: duplicar una diapositiva (su único punto de entrada es add_slide(layout)), preservar el formato a través de text_frame.text = "..." (colapsa el párrafo a una sola ejecución sin estilo — asigna run.text en su lugar), o leer el SVG/EMF que usa la mayoría del arte de las plantillas (add_picture lanza UnidentifiedImageError).
• Los .ppt heredados deben convertirse primero: python scripts/office/soffice.py --headless --convert-to pptx archivo.ppt. Las plantillas .potx se descomprimen y empaquetan de forma idéntica — mantén la extensión .potx en la salida.
• Para reutilizar un icono o imagen de plantilla, duplica una diapositiva o diseño que ya lo contenga.

Al completar una plantilla:

• Si escribes una transformación XML, analiza con defusedxml.minidom — el viaje de ida y vuelta de OOXML a través de xml.etree.ElementTree reescribe los prefijos de espacio de nombres y corrompe la presentación.
• Las ranuras de la plantilla ≠ los elementos de origen. Si la plantilla muestra 4 miembros del equipo y tienes 3, elimina el grupo completo del 4º miembro (imagen + cuadros de texto), no solo su texto — luego verifica si hay elementos visuales huérfanos en la revisión de calidad.
• Un <a:p> por elemento de lista — nunca concatenes elementos en un solo párrafo. Copia el <a:pPr> hermano para preservar el espaciado, y pon b="1" en el <a:rPr> de títulos, encabezados de sección y etiquetas en línea (Estado:, Propietario:).
• Deja que las viñetas hereden del diseño; solo agrega <a:buChar>, <a:buAutoNum> (numeradas) o <a:buNone> para anular — nunca un • literal en el texto.
• El texto con espacios al principio o al final necesita xml:space="preserve" en su <a:t>.

Ideas de diseño

No crees diapositivas aburridas. Las viñetas simples sobre un fondo blanco no impresionarán a nadie. Considera ideas de esta lista para cada diapositiva.

Antes de empezar

• Elige una paleta de colores audaz e informada por el contenido: La paleta debe sentirse diseñada para ESTE tema. Si intercambiar tus colores en una presentación completamente diferente aún "funcionara", no has hecho elecciones lo suficientemente específicas.
• Dominancia sobre igualdad: Un color debe dominar (60-70% de peso visual), con 1-2 tonos de apoyo y un acento marcado. Nunca des a todos los colores el mismo peso.
• Contraste oscuro/claro: Fondos oscuros para diapositivas de título + conclusión, claros para contenido (estructura "sándwich"). O comprométete con oscuro en toda la presentación para una sensación premium.
• Comprométete con un motivo visual: Elige UN elemento distintivo y repítelo — marcos de imagen redondeados, iconos en círculos de colores. Llévalo a través de cada diapositiva. No uses una barra de color o franja de acento como tu motivo (ver lista de Evitar).

Paletas de colores

Elige colores que coincidan con tu tema — no uses azul genérico por defecto. Usa estas paletas como inspiración:

Tema	Primario	Secundario	Acento
Ejecutivo nocturno	1E2761 (azul marino)	CADCFC (azul hielo)	FFFFFF (blanco)
Bosque y musgo	2C5F2D (bosque)	97BC62 (musgo)	F5F5F5 (crema)
Energía coral	F96167 (coral)	F9E795 (oro)	2F3C7E (azul marino)
Terracota cálida	B85042 (terracota)	E7E8D1 (arena)	A7BEAE (salvia)
Degradado oceánico	065A82 (azul profundo)	1C7293 (verde azulado)	21295C (medianoche)
Carbón minimalista	36454F (carbón)	F2F2F2 (blanco roto)	212121 (negro)
Confianza verde azulado	028090 (verde azulado)	00A896 (espuma de mar)	02C39A (menta)
Baya y crema	6D2E46 (baya)	A26769 (rosa polvo)	ECE2D0 (crema)
Calma salvia	84B59F (salvia)	69A297 (eucalipto)	50808E (pizarra)
Rojo cereza audaz	990011 (cereza)	FCF6F5 (blanco roto)	2F3C7E (azul marino)

Para cada diapositiva

Cada diapositiva necesita un elemento visual — imagen, gráfico, icono o forma. Las diapositivas solo de texto son olvidables.

Opciones de diseño:

• Dos columnas (texto a la izquierda, ilustración a la derecha)
• Filas de icono + texto (icono en círculo de color, encabezado en negrita, descripción debajo)
• Cuadrícula 2x2 o 2x3 (imagen en un lado, cuadrícula de bloques de contenido en el otro)
• Imagen de sangría completa (lado izquierdo o derecho completo) con superposición de contenido

Visualización de datos:

• Llamadas de estadísticas grandes (números grandes 60-72pt con etiquetas pequeñas debajo)
• Columnas de comparación (antes/después, pros/contras, opciones lado a lado)
• Línea de tiempo o flujo de proceso (pasos numerados, flechas)

Pulido visual:

• Iconos en pequeños círculos de color junto a los encabezados de sección
• Texto en cursiva para estadísticas clave o lemas

Tipografía

Los nombres de las fuentes que escribes en el .pptx son renderizados por el PowerPoint del usuario, no por este entorno. Tu revisión visual de calidad se renderiza a través de LibreOffice, que sustituye las fuentes que no tiene — y para algunas fuentes el sustituto tiene anchos diferentes, por lo que tu vista previa de calidad puede mostrar desbordamiento de texto (o ajuste) que la presentación real no tendrá. Para mantener tu revisión de calidad confiable:

• Fuentes seguras (se renderizan con el ancho real en la revisión de calidad y vienen con Office): Arial, Calibri, Cambria, Times New Roman, Courier New, Bookman Old Style, Century Schoolbook. Úsalas para el texto del cuerpo y cualquier cosa donde el ajuste importe.
• Encabezados con personalidad con riesgo cero de calidad: combina un encabezado serif de la lista segura (Cambria, Bookman Old Style, Century Schoolbook) con un cuerpo sans de la lista segura (Calibri o Arial). Obtienes contraste visual sin renunciar a verificaciones confiables de desbordamiento.
• Si el usuario pide una fuente fuera de la lista segura (por ejemplo, Georgia o Trebuchet MS): úsala donde el usuario la pidió, pero dimensiona esos contenedores con un margen extra (~10%) y no confíes en la verificación de ajuste de texto de calidad en esos elementos — la vista previa de esa fuente es aproximada. Si el usuario no ha especificado, prefiere fuentes de la lista segura para el texto del cuerpo.
• Fuentes no confiables para revisión de calidad (el sustituto tiene anchos diferentes — las verificaciones de desbordamiento pueden ser incorrectas): Georgia, Trebuchet MS, Impact, Arial Black, Garamond, Consolas, Palatino Linotype. La sustitución de Calibri Light varía según el entorno; trátala como no confiable para revisión de calidad. Bien para títulos/acentos con margen; no confíes en la verificación de ajuste de texto de calidad en estos.
• Nunca uses Aptos por defecto — el valor predeterminado posterior a 2023 de Office no tiene un sustituto compatible con métricas aquí y falta en instalaciones antiguas de Office, por lo que no es confiable en ambos extremos.

Elemento	Tamaño
Título de diapositiva	36-44pt negrita
Encabezado de sección	20-24pt negrita
Texto del cuerpo	14-16pt
Subtítulos	10-12pt atenuado