PPTX

Criação, edição e análise de PPTX

Visão geral

Um arquivo .pptx é um arquivo ZIP contendo arquivos XML e recursos. Crie, edite ou analise apresentações do PowerPoint usando extração de texto, acesso raw XML ou workflows html2pptx. Aplique essa habilidade para criação e modificação programática de apresentações.

Aprimoramento Visual com Esquemas Científicos

Ao criar documentos com essa habilidade, sempre considere adicionar diagramas e esquemas científicos para melhorar a comunicação visual.

Se o seu documento ainda não contém esquemas ou diagramas:

• Use a habilidade scientific-schematics para gerar diagramas de qualidade para publicação com IA
• Simplesmente descreva o diagrama desejado em linguagem natural
• Nano Banana Pro irá gerar, revisar e refinar o esquema automaticamente

Para novos documentos: Esquemas científicos devem ser gerados por padrão para representar visualmente conceitos-chave, workflows, arquiteturas ou relacionamentos descritos no texto.

Como gerar esquemas:

python scripts/generate_schematic.py "sua descrição do diagrama" -o figures/output.png

A IA irá automaticamente:

• Criar imagens de qualidade para publicação com formatação apropriada
• Revisar e refinar através de múltiplas iterações
• Garantir acessibilidade (amigável a daltonismo, alto contraste)
• Salvar outputs no diretório figures/

Quando adicionar esquemas:

• Diagramas de workflow de apresentação para slides
• Fluxogramas do processo de design de slides
• Diagramas de organização de conteúdo
• Ilustrações de arquitetura de sistemas
• Visualizações de fluxo de processos
• Qualquer conceito complexo que se beneficie de visualização

Para orientação detalhada sobre criação de esquemas, consulte a documentação da habilidade scientific-schematics.

Leitura e análise de conteúdo

Extração de texto

Para ler o conteúdo de texto de uma apresentação, converta o documento para markdown:

# Converter documento para markdown
python -m markitdown path-to-file.pptx

Acesso raw XML

Acesso raw XML é necessário para: comentários, anotações do apresentador, layouts de slides, animações, elementos de design e formatação complexa. Para qualquer um desses recursos, desempacote uma apresentação e leia seu conteúdo XML raw.

Desempacotando um arquivo

python ooxml/scripts/unpack.py <office_file> <output_dir>

Nota: O script unpack.py está localizado em skills/pptx/ooxml/scripts/unpack.py relativo à raiz do projeto. Se o script não existir nesse caminho, use find . -name "unpack.py" para localizá-lo.

Estruturas de arquivos principais

• ppt/presentation.xml - Metadados de apresentação principal e referências de slides
• ppt/slides/slide{N}.xml - Conteúdo de slides individuais (slide1.xml, slide2.xml, etc.)
• ppt/notesSlides/notesSlide{N}.xml - Anotações do apresentador para cada slide
• ppt/comments/modernComment_*.xml - Comentários para slides específicos
• ppt/slideLayouts/ - Modelos de layout para slides
• ppt/slideMasters/ - Modelos de master slide
• ppt/theme/ - Informações de tema e estilos
• ppt/media/ - Imagens e outros arquivos de mídia

Extração de tipografia e cor

Quando receber um design de exemplo para emular: Sempre analise a tipografia e cores da apresentação primeiro usando os métodos abaixo:

1. Leia arquivo de tema: Verifique ppt/theme/theme1.xml para cores (<a:clrScheme>) e fontes (<a:fontScheme>)
2. Examine conteúdo de slide: Examine ppt/slides/slide1.xml para uso real de fonte (<a:rPr>) e cores
3. Busque padrões: Use grep para encontrar referências de cor (<a:solidFill>, <a:srgbClr>) e font em todos os arquivos XML

Criando uma nova apresentação do PowerPoint sem um template

Ao criar uma nova apresentação do PowerPoint do zero, use o workflow html2pptx para converter slides HTML em PowerPoint com posicionamento preciso.

Princípios de Design

CRÍTICO: Antes de criar qualquer apresentação, analise o conteúdo e escolha elementos de design apropriados:

1. Considere o assunto: Do que se trata essa apresentação? Qual tom, indústria ou clima ela sugere?
2. Verifique marca: Se o usuário menciona uma empresa/organização, considere suas cores de marca e identidade
3. Combine paleta com conteúdo: Selecione cores que reflitam o assunto
4. Declare sua abordagem: Explique suas escolhas de design antes de escrever código

Requisitos:

• ✅ Declare sua abordagem de design baseada em conteúdo ANTES de escrever código
• ✅ Use apenas fontes web-safe: Arial, Helvetica, Times New Roman, Georgia, Courier New, Verdana, Tahoma, Trebuchet MS, Impact
• ✅ Crie clara hierarquia visual através de tamanho, peso e cor
• ✅ Garanta legibilidade: contraste forte, texto adequadamente dimensionado, alinhamento limpo
• ✅ Seja consistente: repita padrões, espaçamento e linguagem visual entre slides

Seleção de Paleta de Cores

Escolhendo cores criativamente:

• Pense além dos defaults: Que cores genuinamente combinam com este tópico específico? Evite escolhas no automático.
• Considere múltiplos ângulos: Tópico, indústria, clima, nível de energia, público-alvo, identidade de marca (se mencionada)
• Seja aventureiro: Tente combinações inesperadas - uma apresentação de saúde não precisa ser verde, finanças não precisa ser azul marinho
• Construa sua paleta: Escolha 3-5 cores que funcionem bem juntas (cores dominantes + tons de suporte + acentos)
• Garanta contraste: Texto deve ser claramente legível sobre fundos

Exemplos de paletas de cores (use estes para inspirar criatividade - escolha uma, adapte ou crie a sua):

1. Blue Clássico: Azul marinho profundo (#1C2833), cinza ardósia (#2E4053), prata (#AAB7B8), branco desativado (#F4F6F6)
2. Teal & Coral: Teal (#5EA8A7), teal profundo (#277884), coral (#FE4447), branco (#FFFFFF)
3. Vermelho Ousado: Vermelho (#C0392B), vermelho brilhante (#E74C3C), laranja (#F39C12), amarelo (#F1C40F), verde (#2ECC71)
4. Blush Caloroso: Malva (#A49393), blush (#EED6D3), rosa (#E8B4B8), creme (#FAF7F2)
5. Luxo Borgonha: Borgonha (#5D1D2E), carmesim (#951233), ferrugem (#C15937), ouro (#997929)
6. Roxo Profundo & Esmeralda: Roxo (#B165FB), azul escuro (#181B24), esmeralda (#40695B), branco (#FFFFFF)
7. Creme & Verde Floresta: Creme (#FFE1C7), verde floresta (#40695B), branco (#FCFCFC)
8. Rosa & Roxo: Rosa (#F8275B), coral (#FF574A), rosa (#FF737D), roxo (#3D2F68)
9. Limão & Ameixa: Limão (#C5DE82), ameixa (#7C3A5F), coral (#FD8C6E), cinza-azulado (#98ACB5)
10. Preto & Ouro: Ouro (#BF9A4A), preto (#000000), creme (#F4F6F6)
11. Sálvia & Terracota: Sálvia (#87A96B), terracota (#E07A5F), creme (#F4F1DE), carvão (#2C2C2C)
12. Carvão & Vermelho: Carvão (#292929), vermelho (#E33737), cinza-claro (#CCCBCB)
13. Laranja Vibrante: Laranja (#F96D00), cinza-claro (#F2F2F2), carvão (#222831)
14. Verde Floresta: Preto (#191A19), verde (#4E9F3D), verde escuro (#1E5128), branco (#FFFFFF)
15. Arco-Íris Retrô: Roxo (#722880), rosa (#D72D51), laranja (#EB5C18), âmbar (#F08800), ouro (#DEB600)
16. Terroso Vintage: Mostarda (#E3B448), sálvia (#CBD18F), verde floresta (#3A6B35), creme (#F4F1DE)
17. Rosa Costeira: Rosa envelhecida (#AD7670), castor (#B49886), casca de ovo (#F3ECDC), cinza cinzento (#BFD5BE)
18. Laranja & Turquesa: Laranja-claro (#FC993E), turquesa acinzentada (#667C6F), branco (#FCFCFC)

Opções de Detalhes Visuais

Padrões Geométricos:

• Divisores de seção diagonal em vez de horizontal
• Larguras de coluna assimétricas (30/70, 40/60, 25/75)
• Texto de header rotacionado em 90° ou 270°
• Frames circulares/hexagonais para imagens
• Formas triangulares de destaque nos cantos
• Formas sobrepostas para profundidade

Tratamentos de Borda & Frame:

• Bordas de cor única espessa (10-20pt) apenas em um lado
• Bordas de duas linhas com cores contrastantes
• Colchetes de canto em vez de frames completos
• Bordas em L (superior+esquerda ou inferior+direita)
• Acentos de sublinhado sob headers (3-5pt de espessura)

Tratamentos de Tipografia:

• Contraste de tamanho extremo (headlines de 72pt vs corpo de 11pt)
• Headers em all-caps com espaçamento de letra amplo
• Seções numeradas em tipo de exibição oversized
• Monospace (Courier New) para dados/estatísticas/conteúdo técnico
• Fontes condensadas (Arial Narrow) para informações densas
• Texto delineado para ênfase

Estilo de Gráfico & Dados:

• Gráficos monocromáticos com cor de destaque única para dados-chave
• Gráficos de barra horizontal em vez de vertical
• Gráficos de pontos em vez de gráficos de barra
• Linhas de grade mínimas ou nenhuma
• Rótulos de dados diretamente em elementos (sem legendas)
• Números oversized para métricas-chave

Inovações de Layout:

• Imagens full-bleed com sobreposições de texto
• Coluna da lateral (20-30% de largura) para navegação/contexto
• Sistemas de grade modular (blocos 3×3, 4×4)
• Fluxo de conteúdo padrão Z ou F
• Caixas de texto flutuante sobre formas coloridas
• Layouts de múltiplas colunas estilo revista

Tratamentos de Fundo:

• Blocos de cor sólida ocupando 40-60% do slide
• Preenchimentos de gradiente (apenas vertical ou diagonal)
• Fundos divididos (duas cores, diagonal ou vertical)
• Bandas de cor de borda a borda
• Espaço negativo como elemento de design

Dicas de Layout

Para slides com gráficos ou tabelas:

• Layout de duas colunas (PREFERIDO): Use um header abrangendo a largura total, depois duas colunas abaixo - texto/bullets em uma coluna e o conteúdo em destaque em outra. Isso proporciona melhor equilíbrio e torna gráficos/tabelas mais legíveis. Use flexbox com larguras de coluna desiguais (ex: divisão 40%/60%) para otimizar espaço para cada tipo de conteúdo.
• Layout de slide completo: Deixe o conteúdo em destaque (gráfico/tabela) ocupar o slide inteiro para máximo impacto e legibilidade
• NUNCA empilhe verticalmente: Não coloque gráficos/tabelas abaixo de texto em uma única coluna - isso causa problemas de legibilidade e layout

Workflow

1. OBRIGATÓRIO - LEIA ARQUIVO INTEIRO: Leia html2pptx.md completamente do início ao fim. NUNCA defina limites de intervalo ao ler este arquivo. Leia o conteúdo completo do arquivo para sintaxe detalhada, regras de formatação críticas e melhores práticas antes de prosseguir com a criação de apresentação.
2. Crie um arquivo HTML para cada slide com dimensões apropriadas (ex: 720pt × 405pt para 16:9)
   • Use <p>, <h1>-<h6>, <ul>, <ol> para todo conteúdo de texto
   • Use class="placeholder" para áreas onde gráficos/tabelas serão adicionados (renderize com fundo cinza para visibilidade)
   • CRÍTICO: Rasterize gradientes e ícones como imagens PNG PRIMEIRO usando Sharp, depois referencie em HTML
   • LAYOUT: Para slides com gráficos/tabelas/imagens, use layout de slide completo ou layout de duas colunas para melhor legibilidade
3. Crie e execute um arquivo JavaScript usando a biblioteca html2pptx.js para converter slides HTML em PowerPoint e salvar a apresentação
   • Use a função html2pptx() para processar cada arquivo HTML
   • Adicione gráficos e tabelas a áreas placeholder usando API PptxGenJS
   • Salve a apresentação usando pptx.writeFile()
4. Validação visual: Gere miniaturas e inspecione problemas de layout
   • Crie grid de miniaturas: python scripts/thumbnail.py output.pptx workspace/thumbnails --cols 4
   • Leia e examine cuidadosamente a imagem de miniatura para:
     • Corte de texto: Texto sendo cortado por barras de header, formas ou bordas de slide
     • Sobreposição de texto: Texto sobrepondo outro texto ou formas
     • Problemas de posicionamento: Conteúdo muito perto de bordas de slide ou outros elementos
     • Problemas de contraste: Contraste insuficiente entre texto e fundos
   • Se problemas encontrados, ajuste margens/espaçamento/cores de HTML e regenere a apresentação
   • Repita até que todos os slides estejam visualmente corretos

Editando uma apresentação do PowerPoint existente

Para editar slides em uma apresentação do PowerPoint existente, trabalhe com o formato Office Open XML (OOXML) raw. Isso envolve desempacotar o arquivo .pptx, editar conteúdo XML e reempacotá-lo.

Workflow

1. OBRIGATÓRIO - LEIA ARQUIVO INTEIRO: Leia ooxml.md (~500 linhas) completamente do início ao fim. NUNCA defina limites de intervalo ao ler este arquivo. Leia o conteúdo completo do arquivo para orientação detalhada sobre estrutura OOXML e workflows de edição antes de qualquer edição de apresentação.
2. Desempacote a apresentação: python ooxml/scripts/unpack.py <office_file> <output_dir>
3. Edite os arquivos XML (principalmente ppt/slides/slide{N}.xml e arquivos relacionados)
4. CRÍTICO: Valide imediatamente após cada edição e corrija erros de validação antes de prosseguir: python ooxml/scripts/validate.py <dir> --original <file>
5. Empacote a apresentação final: python ooxml/scripts/pack.py <input_directory> <office_file>

Criando uma nova apresentação do PowerPoint usando um template

Para criar uma apresentação que segue o design de um template existente, duplique e reorganize slides de template antes de substituir conteúdo placeholder.

Workflow

1. Extraia texto do template E crie grid de miniaturas visuais:

   • Extraia texto: python -m markitdown template.pptx > template-content.md
   • Leia template-content.md: Leia o arquivo inteiro para entender os conteúdos da apresentação do template. NUNCA defina limites de intervalo ao ler este arquivo.
   • Crie grids de miniaturas: python scripts/thumbnail.py template.pptx
   • Veja seção Criando Grids de Miniaturas para mais detalhes

2. Analise template e salve inventário em um arquivo:

   • Análise Visual: Revise grid de miniaturas para entender layouts de slides, padrões de design e estrutura visual
   • Crie e salve um arquivo de inventário de template em template-inventory.md contendo:

     # Análise de Inventário de Template
     **Total de Slides: [contagem]**
     **IMPORTANTE: Slides são 0-indexados (primeiro slide = 0, último slide = contagem-1)**
     
     ## [Nome da Categoria]
     - Slide 0: [Código de layout se disponível] - Descrição/propósito
     - Slide 1: [Código de layout] - Descrição/propósito
     - Slide 2: [Código de layout] - Descrição/propósito
     [... CADA slide deve ser listado individualmente com seu índice ...]
     

   • Usando grid de miniaturas: Referencie as miniaturas visuais para identificar:
     • Padrões de layout (slides de título, layouts de conteúdo, divisores de seção)
     • Localizações e contagens de placeholder de imagem
     • Consistência de design entre grupos de slides
     • Hierarquia visual e estrutura
   • Este arquivo de inventário é OBRIGATÓRIO para selecionar templates apropriados no próximo passo

3. Crie outline de apresentação baseado em inventário de template:

   • Revise templates disponíveis do passo 2.
   • Escolha um template de intro ou título para o primeiro slide. Este deve ser um dos primeiros templates.
   • Escolha layouts seguros, baseados em texto para os outros slides.
   • CRÍTICO: Combine estrutura de layout com conteúdo real:
     • Layouts de coluna única: Use para narrativa unificada ou tópico único
     • Layouts de duas colunas: Use APENAS quando houver exatamente 2 itens/conceitos distintos
     • Layouts de três colunas: Use APENAS quando houver exatamente 3 itens/conceitos distintos
     • Layouts de imagem + texto: Use APENAS quando houver imagens reais para inserir
     • Layouts de citação: Use APENAS para citações reais de pessoas (com atribuição), nunca para ênfase
     • Nunca use layouts com mais placeholders que conteúdo disponível
     • Se houver 2 itens, não force em layout de 3 colunas
     • Se houver 4+ itens, considere quebrar em múltiplos slides ou usar formato de lista
   • Conte as peças de conteúdo reais ANTES de selecionar o layout
   • Verifique cada placeholder no layout escolhido será preenchido com conteúdo significativo
   • Selecione uma opção representando o layout melhor para cada seção de conteúdo.
   • Salve outline.md com conteúdo E mapeamento de template que aproveita designs disponíveis
   • Exemplo de mapeamento de template:

     # Templates de slides a usar (indexação baseada em 0)
     # AVISO: Verifique que índices estão no intervalo! Template com 73 slides tem índices 0-72
     # Mapeamento: números de slide do outline -> índices de slide do template
     template_mapping = [
         0,   # Use slide 0 (Title/Cover)
         34,  # Use slide 34 (B1: Title and body)
         34,  # Use slide 34 novamente (duplicar para segundo B1)
         50,  # Use slide 50 (E1: Quote)
         54,  # Use slide 54 (F2: Closing + Text)
     ]
     

4. Duplique, reorganize e delete slides usando rearrange.py:

   • Use o script scripts/rearrange.py para criar uma nova apresentação com slides na ordem desejada:

     python scripts/rearrange.py template.pptx working.pptx 0,34,34,50,52
     

   • O script lida com duplicação de slides repetidos, deletion de slides não utilizados e reordenação automaticamente
   • Índices de slide são baseados em 0 (primeiro slide é 0, segundo é 1, etc.)
   • O mesmo índice de slide pode aparecer múltiplas vezes para duplicar esse slide

5. Extraia TODO o texto usando o script inventory.py:

   • Execute extração de inventário:

     python scripts/inventory.py working.pptx text-inventory.json
     

   • Leia text-inventory.json: Leia o arquivo text-inventory.json inteiro para entender todas as formas e suas propriedades. NUNCA defina limites de intervalo ao ler este arquivo.

   • A estrutura JSON de inventário:

       {
         "slide-0": {
           "shape-0": {
             "placeholder_type": "TITLE",  // ou null para não-placeholders
             "left": 1.5,                  // posição em polegadas
             "top": 2.0,
             "width": 7.5,
             "height": 1.2,
             "paragraphs": [
               {
                 "text": "Texto do parágrafo",
                 // Propriedades opcionais (incluídas apenas quando não-padrão):
                 "bullet": true,           // bullet explícito detectado
                 "level": 0,               // incluído apenas quando bullet é true
                 "alignment": "CENTER",    // CENTER, RIGHT (não LEFT)
                 "space_before": 10.0,     // espaço antes do parágrafo em pontos
                 "space_after": 6.0,       // espaço após parágrafo em pontos
                 "line_spacing": 22.4,     // espaçamento de linha em pontos
                 "font_name": "Arial",     // da primeira execução
                 "font_size": 14.0,        // em pontos
                 "bold": true,
                 "italic": false,
                 "underline": false,
                 "color": "FF0000"         // cor RGB
               }
             ]
           }
         }
       }
     

   • Principais características:

     • Slides: Nomeados como "slide-0", "slide-1", etc.
     • Formas: Ordenadas por posição visual (topo-para-baixo, esquerda-para-direita) como "shape-0", "shape-1", etc.
     • Tipos de placeholder: TITLE, CENTER_TITLE, SUBTITLE, BODY, OBJECT, ou null
     • Tamanho de fonte padrão: default_font_size em pontos extraído de placeholders de layout (quando disponível)
     • Números de slide são filtrados: Formas com tipo de placeholder SLIDE_NUMBER são automaticamente excluídas do inventário
     • Bullets: Quando bullet: true, level é sempre incluído (mesmo que 0)
     • Espaçamento: space_before, space_after e line_spacing em pontos (incluídos apenas quando definidos)
     • Cores: color para RGB (ex: "FF0000"), theme_color para cores de tema (ex: "DARK_1")
     • Propriedades: Apenas valores não-padrão são incluídos no output

6. Gere texto de substituição e salve os dados em um arquivo JSON Baseado no inventário de texto do passo anterior:

   • CRÍTICO: Primeiro verifique quais formas existem no inventário - apenas referencie formas que estão realmente presentes
   • VALIDAÇÃO: O script replace.py irá validar que todas as formas no JSON de substituição existem no inventário
     • Se uma forma não-existente for referenciada, um erro mostrará as formas disponíveis
     • Se um slide não-existente for referenciado, um erro indicará que o slide não existe
     • Todos os erros de validação são mostrados de uma vez antes do script sair
   • IMPORTANTE: O script replace.py usa inventory.py internamente para identificar TODAS as formas de texto
   • LIMPEZA AUTOMÁTICA: TODAS as formas de texto do inventário serão limpas a menos que você forneça "paragraphs" para elas
   • Adicione um campo "paragraphs" a formas que precisam de conteúdo (não "replacement_paragraphs")
   • Formas sem "paragraphs" no JSON de substituição terão seu texto limpo automaticamente
   • Parágrafos com bullets serão automaticamente alinhados à esquerda. Não defina a propriedade alignment quando "bullet": true
   • Gere conteúdo de substituição apropriado para texto placeholder
   • Use tamanho de forma para determinar comprimento apropriado de conteúdo
   • CRÍTICO: Inclua propriedades de parágrafo do inventário original - não apenas forneça texto
   • IMPORTANTE: Quando bullet: true, NÃO inclua símbolos de bullet (•, -, *) no texto - eles são adicionados automaticamente
   • REGRAS ESSENCIAIS DE FORMATAÇÃO:
     • Headers/títulos devem tipicamente ter "bold": true
     • Itens de lista devem ter "bullet": true, "level": 0 (level é necessário quando bullet é true)
     • Preserve qualquer propriedade de alinhamento (ex: "alignment": "CENTER" para texto centralizado)
     • Inclua propriedades de fonte quando diferentes do padrão (ex: "font_size": 14.0, "font_name": "Lora")
     • Cores: Use "color": "FF0000" para RGB ou "theme_color": "DARK_1" para cores de tema
     • O script de substituição espera parágrafos adequadamente formatados, não apenas strings de texto
     • Formas sobrepostas: Prefira formas com maior default_font_size ou placeholder_type mais apropriado
   • Salve o inventário atualizado com substituições em replacement-text.json
   • AVISO: Diferentes layouts de template têm contagens de formas diferentes - sempre verifique o inventário real antes de criar substituições

   Exemplo de campo paragraphs mostrando formatação apropriada:

   "paragraphs": [
     {
       "text": "Novo texto de título de apresentação",
       "alignment": "CENTER",
       "bold": true
     },
     {
       "text": "Cabeçalho de Seção",
       "bold": true
     },
     {
       "text": "Primeiro ponto de bullet sem símbolo de bullet",
       "bullet": true,
       "level": 0
     },
     {
       "text": "Texto com cor vermelha",
       "color": "FF0000"
     },
     {
       "text": "Texto com cor de tema",
       "theme_color": "DARK_1"
     },
     {
       "text": "Texto de parágrafo regular sem formatação especial"
     }
   ]
   

   Formas não listadas no JSON de substituição são automaticamente limpas:

   {
     "slide-0": {
       "shape-0": {
         "paragraphs": [...] // Esta forma obtém novo texto
       }
       // shape-1 e shape-2 do inventário serão limpas automaticamente
     }
   }
   

   Padrões de formatação comuns para apresentações:

   • Slides de título: Texto em bold, às vezes centralizado
   • Headers de seção dentro de slides: Texto em bold
   • Listas de bullets: Cada item precisa "bullet": true, "level": 0
   • Texto de corpo: Geralmente sem propriedades especiais
   • Citações: Podem ter propriedades de alinhamento ou fonte especiais

7. Aplique substituições usando o script replace.py

   python scripts/replace.py working.pptx replacement-text.json output.pptx
   

   O script irá:

   • Primeiro extrair o inventário de TODAS as formas de texto usando funções de inventory.py
   • Validar que todas as formas no JSON de substituição existem no inventário
   • Limpar texto de TODAS as formas identificadas no inventário
   • Aplicar novo texto apenas às formas com "paragraphs" defin