Creación, edición y análisis de PPTX
Descripción general
Un usuario puede pedirte que crees, edites o analices el contenido de un archivo .pptx. Un archivo .pptx es esencialmente un archivo ZIP que contiene archivos XML y otros recursos que puedes leer o editar. Dispones de diferentes herramientas y flujos de trabajo para diferentes tareas.
Lectura y análisis de contenido
Extracción de texto
Si solo necesitas leer el contenido de texto de una presentación, debes convertir el documento a markdown:
# Convertir documento a markdown
python -m markitdown ruta-al-archivo.pptx
Acceso XML sin procesar
Necesitas acceso XML sin procesar para: comentarios, notas del orador, diseños de diapositivas, animaciones, elementos de diseño y formato complejo. Para cualquiera de estas características, deberás desempaquetar una presentación y leer su contenido XML sin procesar.
Desempaquetar un archivo
python ooxml/scripts/unpack.py <archivo_oficina> <directorio_salida>
Nota: El script unpack.py se encuentra en skills/pptx/ooxml/scripts/unpack.py relativo a la raíz del proyecto. Si el script no existe en esta ruta, usa find . -name "unpack.py" para localizarlo.
Estructuras de archivos clave
ppt/presentation.xml- Metadatos principales de la presentación y referencias a diapositivasppt/slides/slide{N}.xml- Contenido de diapositivas individuales (slide1.xml, slide2.xml, etc.)ppt/notesSlides/notesSlide{N}.xml- Notas del orador para cada diapositivappt/comments/modernComment_*.xml- Comentarios para diapositivas específicasppt/slideLayouts/- Plantillas de diseño para diapositivasppt/slideMasters/- Plantillas maestras de diapositivasppt/theme/- Información de tema y estiloppt/media/- Imágenes y otros archivos multimedia
Extracción de tipografía y color
Cuando se te dé un ejemplo de diseño a emular: Analiza primero la tipografía y los colores de la presentación usando los métodos siguientes:
- Lee el archivo de tema: Verifica
ppt/theme/theme1.xmlpara colores (<a:clrScheme>) y fuentes (<a:fontScheme>) - Examina el contenido de una diapositiva de muestra: Revisa
ppt/slides/slide1.xmlpara el uso real de fuentes (<a:rPr>) y colores - Busca patrones: Usa grep para encontrar referencias de color (
<a:solidFill>,<a:srgbClr>) y fuentes en todos los archivos XML
Crear una nueva presentación de PowerPoint sin una plantilla
Al crear una nueva presentación de PowerPoint desde cero, usa el flujo de trabajo html2pptx para convertir diapositivas HTML a PowerPoint con posicionamiento preciso.
Principios de diseño
CRÍTICO: Antes de crear cualquier presentación, analiza el contenido y elige elementos de diseño apropiados:
- Considera el tema: ¿De qué trata esta presentación? ¿Qué tono, industria o ambiente sugiere?
- Verifica la marca: Si el usuario menciona una empresa/organización, considera sus colores de marca e identidad
- Combina la paleta con el contenido: Selecciona colores que reflejen el tema
- Explica tu enfoque: Justifica tus elecciones de diseño antes de escribir código
Requisitos:
- ✅ Indica tu enfoque de diseño basado en el contenido ANTES de escribir código
- ✅ Usa solo fuentes seguras para la web: Arial, Helvetica, Times New Roman, Georgia, Courier New, Verdana, Tahoma, Trebuchet MS, Impact
- ✅ Crea una jerarquía visual clara mediante tamaño, peso y color
- ✅ Asegura la legibilidad: buen contraste, texto de tamaño apropiado, alineación limpia
- ✅ Sé consistente: repite patrones, espaciado y lenguaje visual en todas las diapositivas
Selección de paleta de colores
Elegir colores creativamente:
- Piensa más allá de los valores predeterminados: ¿Qué colores realmente combinan con este tema específico? Evita elecciones automáticas.
- Considera múltiples ángulos: Tema, industria, ambiente, nivel de energía, público objetivo, identidad de marca (si se menciona)
- Sé aventurero: Prueba combinaciones inesperadas: una presentación de salud no tiene que ser verde, finanzas no tiene que ser azul marino
- Construye tu paleta: Elige de 3 a 5 colores que funcionen juntos (colores dominantes + tonos de apoyo + acento)
- Asegura el contraste: El texto debe ser claramente legible sobre los fondos
Ejemplos de paletas de colores (usa estos para inspirarte: elige uno, adáptalo o crea el tuyo propio):
- Azul clásico: Azul marino profundo (#1C2833), gris pizarra (#2E4053), plata (#AAB7B8), blanco roto (#F4F6F6)
- Verde azulado y coral: Verde azulado (#5EA8A7), verde azulado oscuro (#277884), coral (#FE4447), blanco (#FFFFFF)
- Rojo audaz: Rojo (#C0392B), rojo brillante (#E74C3C), naranja (#F39C12), amarillo (#F1C40F), verde (#2ECC71)
- Rosa cálido: Malva (#A49393), sonrosado (#EED6D3), rosa (#E8B4B8), crema (#FAF7F2)
- Lujo burdeos: Burdeos (#5D1D2E), carmesí (#951233), óxido (#C15937), dorado (#997929)
- Púrpura profundo y esmeralda: Púrpura (#B165FB), azul oscuro (#181B24), esmeralda (#40695B), blanco (#FFFFFF)
- Crema y verde bosque: Crema (#FFE1C7), verde bosque (#40695B), blanco (#FCFCFC)
- Rosa y púrpura: Rosa (#F8275B), coral (#FF574A), rosa (#FF737D), púrpura (#3D2F68)
- Lima y ciruela: Lima (#C5DE82), ciruela (#7C3A5F), coral (#FD8C6E), azul grisáceo (#98ACB5)
- Negro y dorado: Dorado (#BF9A4A), negro (#000000), crema (#F4F6F6)
- Salvia y terracota: Salvia (#87A96B), terracota (#E07A5F), crema (#F4F1DE), carbón (#2C2C2C)
- Carbón y rojo: Carbón (#292929), rojo (#E33737), gris claro (#CCCBCB)
- Naranja vibrante: Naranja (#F96D00), gris claro (#F2F2F2), carbón (#222831)
- Verde bosque: Negro (#191A19), verde (#4E9F3D), verde oscuro (#1E5128), blanco (#FFFFFF)
- Arcoíris retro: Púrpura (#722880), rosa (#D72D51), naranja (#EB5C18), ámbar (#F08800), dorado (#DEB600)
- Terroso vintage: Mostaza (#E3B448), salvia (#CBD18F), verde bosque (#3A6B35), crema (#F4F1DE)
- Rosa costero: Rosa antiguo (#AD7670), castor (#B49886), cáscara de huevo (#F3ECDC), gris ceniza (#BFD5BE)
- Naranja y turquesa: Naranja claro (#FC993E), turquesa grisáceo (#667C6F), blanco (#FCFCFC)
Opciones de detalles visuales
Patrones geométricos:
- Divisores de sección diagonales en lugar de horizontales
- Anchos de columna asimétricos (30/70, 40/60, 25/75)
- Encabezados de texto rotados a 90° o 270°
- Marcos circulares/hexagonales para imágenes
- Formas de acento triangulares en las esquinas
- Formas superpuestas para dar profundidad
Tratamientos de bordes y marcos:
- Bordes gruesos de un solo color (10-20 pt) en un solo lado
- Bordes de línea doble con colores contrastantes
- Soportes de esquina en lugar de marcos completos
- Bordes en forma de L (superior+izquierdo o inferior+derecho)
- Acentos subrayados debajo de los encabezados (3-5 pt de grosor)
Tratamientos tipográficos:
- Contraste extremo de tamaño (titulares de 72 pt frente a cuerpo de 11 pt)
- Encabezados en mayúsculas con espaciado amplio entre letras
- Secciones numeradas en tipo de letra sobredimensionada
- Monoespaciada (Courier New) para datos/estadísticas/contenido técnico
- Fuentes condensadas (Arial Narrow) para información densa
- Texto contorneado para énfasis
Estilo de gráficos y datos:
- Gráficos monocromáticos con un solo color de acento para datos clave
- Gráficos de barras horizontales en lugar de verticales
- Gráficos de puntos en lugar de gráficos de barras
- Líneas de cuadrícula mínimas o ninguna
- Etiquetas de datos directamente sobre los elementos (sin leyendas)
- Números sobredimensionados para métricas clave
Innovaciones de diseño:
- Imágenes a sangre completa con superposiciones de texto
- Columna lateral (ancho 20-30%) para navegación/contexto
- Sistemas de cuadrícula modular (bloques 3×3, 4×4)
- Flujo de contenido en patrón Z o patrón F
- Cuadros de texto flotantes sobre formas de colores
- Diseños de varias columnas al estilo revista
Tratamientos de fondo:
- Bloques de color sólido que ocupan 40-60% de la diapositiva
- Rellenos degradados (solo verticales o diagonales)
- Fondos divididos (dos colores, diagonal o vertical)
- Bandas de color de borde a borde
- Espacio negativo como elemento de diseño
Consejos de diseño
Al crear diapositivas con gráficos o tablas:
- Diseño de dos columnas (PREFERIDO): Usa un encabezado que abarque todo el ancho, luego dos columnas debajo: texto/viñetas en una columna y el contenido destacado en la otra. Esto proporciona un mejor equilibrio y hace que los gráficos/tablas sean más legibles. Usa flexbox con anchos de columna desiguales (por ejemplo, 40%/60%) para optimizar el espacio para cada tipo de contenido.
- Diseño de diapositiva completa: Deja que el contenido destacado (gráfico/tabla) ocupe toda la diapositiva para lograr el máximo impacto y legibilidad
- NUNCA apiles verticalmente: No coloques gráficos/tablas debajo del texto en una sola columna, ya que esto provoca mala legibilidad y problemas de diseño
Flujo de trabajo
- OBLIGATORIO - LEE EL ARCHIVO COMPLETO: Lee
html2pptx.mdcompletamente de principio a fin. NUNCA establezcas límites de rango al leer este archivo. Lee el contenido completo del archivo para obtener sintaxis detallada, reglas de formato críticas y mejores prácticas antes de proceder con la creación de la presentación. - Crea un archivo HTML para cada diapositiva con las dimensiones adecuadas (por ejemplo, 720 pt × 405 pt para 16:9)
- Usa
<p>,<h1>-<h6>,<ul>,<ol>para todo el contenido de texto - Usa
class="placeholder"para áreas donde se agregarán gráficos/tablas (renderiza con fondo gris para visibilidad) - CRÍTICO: Rasteriza degradados e iconos como imágenes PNG primero usando Sharp, luego haz referencia en HTML
- DISEÑO: Para diapositivas con gráficos/tablas/imágenes, usa diseño de diapositiva completa o diseño de dos columnas para mejor legibilidad
- Usa
- Crea y ejecuta un archivo JavaScript usando la biblioteca
html2pptx.jspara convertir diapositivas HTML a PowerPoint y guardar la presentación- Usa la función
html2pptx()para procesar cada archivo HTML - Agrega gráficos y tablas a áreas de marcador de posición usando la API de PptxGenJS
- Guarda la presentación usando
pptx.writeFile()
- Usa la función
- Validación visual: Genera miniaturas e inspecciona problemas de diseño
- Crea una cuadrícula de miniaturas:
python scripts/thumbnail.py output.pptx workspace/thumbnails --cols 4 - Lee y examina cuidadosamente la imagen de la miniatura para detectar:
- Texto cortado: Texto cortado por barras de encabezado, formas o bordes de diapositiva
- Superposición de texto: Texto superpuesto con otro texto o formas
- Problemas de posicionamiento: Contenido demasiado cerca de los límites de la diapositiva u otros elementos
- Problemas de contraste: Contraste insuficiente entre el texto y los fondos
- Si se encuentran problemas, ajusta los márgenes/espaciado/colores del HTML y regenera la presentación
- Repite hasta que todas las diapositivas sean visualmente correctas
- Crea una cuadrícula de miniaturas:
Editar una presentación de PowerPoint existente
Al editar diapositivas en una presentación de PowerPoint existente, debes trabajar con el formato Office Open XML (OOXML) sin procesar. Esto implica desempaquetar el archivo .pptx, editar el contenido XML y reempaquetarlo.
Flujo de trabajo
- OBLIGATORIO - LEE EL ARCHIVO COMPLETO: Lee
ooxml.md(~500 líneas) completamente de principio a fin. NUNCA establezcas límites de rango al leer este archivo. Lee el contenido completo del archivo para obtener orientación detallada sobre la estructura OOXML y los flujos de trabajo de edición antes de cualquier edición de presentación. - Desempaqueta la presentación:
python ooxml/scripts/unpack.py <archivo_oficina> <directorio_salida> - Edita los archivos XML (principalmente
ppt/slides/slide{N}.xmly archivos relacionados) - CRÍTICO: Valida inmediatamente después de cada edición y corrige cualquier error de validación antes de continuar:
python ooxml/scripts/validate.py <dir> --original <archivo> - Empaqueta la presentación final:
python ooxml/scripts/pack.py <directorio_entrada> <archivo_oficina>
Crear una nueva presentación de PowerPoint usando una plantilla
Cuando necesites crear una presentación que siga el diseño de una plantilla existente, deberás duplicar y reorganizar las diapositivas de la plantilla antes de reemplazar el contenido del marcador de posición.
Flujo de trabajo
-
Extrae el texto de la plantilla Y crea una cuadrícula de miniaturas visual:
- Extrae texto:
python -m markitdown template.pptx > template-content.md - Lee
template-content.md: Lee el archivo completo para comprender el contenido de la presentación de la plantilla. NUNCA establezcas límites de rango al leer este archivo. - Crea cuadrículas de miniaturas:
python scripts/thumbnail.py template.pptx - Consulta la sección Creación de cuadrículas de miniaturas para más detalles
- Extrae texto:
-
Analiza la plantilla y guarda un inventario en un archivo:
- Análisis visual: Revisa la(s) cuadrícula(s) de miniaturas para comprender los diseños de diapositivas, patrones de diseño y estructura visual
- Crea y guarda un archivo de inventario de plantilla en
template-inventory.mdque contenga:# Análisis de inventario de plantilla **Diapositivas totales: [número]** **IMPORTANTE: Las diapositivas están indexadas desde 0 (primera diapositiva = 0, última diapositiva = número-1)** ## [Nombre de categoría] - Diapositiva 0: [Código de diseño si está disponible] - Descripción/propósito - Diapositiva 1: [Código de diseño] - Descripción/propósito - Diapositiva 2: [Código de diseño] - Descripción/propósito [... CADA diapositiva debe enumerarse individualmente con su índice ...] - Usando la cuadrícula de miniaturas: Consulta las miniaturas visuales para identificar:
- Patrones de diseño (diapositivas de título, diseños de contenido, divisores de sección)
- Ubicaciones y recuentos de marcadores de posición de imagen
- Consistencia de diseño entre grupos de diapositivas
- Jerarquía y estructura visual
- Este archivo de inventario es OBLIGATORIO para seleccionar plantillas apropiadas en el siguiente paso
-
Crea un esquema de presentación basado en el inventario de plantilla:
- Revisa las plantillas disponibles del paso 2.
- Elige una plantilla de introducción o título para la primera diapositiva. Esta debe ser una de las primeras plantillas.
- Elige diseños seguros basados en texto para las otras diapositivas.
- CRÍTICO: Haz coincidir la estructura del diseño con el contenido real:
- Diseños de una columna: Úsalos para narrativa unificada o un solo tema
- Diseños de dos columnas: Úsalos SOLO cuando tengas exactamente 2 elementos/conceptos distintos
- Diseños de tres columnas: Úsalos SOLO cuando tengas exactamente 3 elementos/conceptos distintos
- Diseños de imagen + texto: Úsalos SOLO cuando tengas imágenes reales para insertar
- Diseños de cita: Úsalos SOLO para citas reales de personas (con atribución), nunca para énfasis
- Nunca uses diseños con más marcadores de posición de los que tienes contenido
- Si tienes 2 elementos, no los fuerces en un diseño de 3 columnas
- Si tienes 4+ elementos, considera dividirlos en varias diapositivas o usar un formato de lista
- Cuenta tus piezas de contenido real ANTES de seleccionar el diseño
- Verifica que cada marcador de posición en el diseño elegido se llenará con contenido significativo
- Selecciona una opción que represente el mejor diseño para cada sección de contenido.
- Guarda
outline.mdcon el contenido Y la asignación de plantilla que aproveche los diseños disponibles - Ejemplo de asignación de plantilla:
...
[truncado para traducción]