marketplace

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

Visão geral

Um usuário pode solicitar que você crie, edite ou analise o conteúdo de um arquivo .pptx. Um arquivo .pptx é essencialmente um arquivo ZIP contendo arquivos XML e outros recursos que você pode ler ou editar. Você tem diferentes ferramentas e fluxos de trabalho disponíveis para diferentes tarefas.

Leitura e análise de conteúdo

Extração de texto

Se você precisar apenas ler o conteúdo textual de uma apresentação, converta o documento para markdown:

# Converte documento para markdown
python -m markitdown caminho-para-arquivo.pptx

Acesso XML bruto

Você precisa de acesso XML bruto para: comentários, notas do apresentador, layouts de slides, animações, elementos de design e formatação complexa. Para qualquer um desses recursos, você precisará descompactar uma apresentação e ler seu conteúdo XML bruto.

Descompactando um arquivo

python ooxml/scripts/unpack.py <arquivo_office> <diretório_saida>

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

Estruturas de arquivo chave

• ppt/presentation.xml - Metadados principais da apresentação e referências de slides
• ppt/slides/slide{N}.xml - Conteúdo individual de cada slide (slide1.xml, slide2.xml, etc.)
• ppt/notesSlides/notesSlide{N}.xml - Notas 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 mestre de slides
• ppt/theme/ - Informações de tema e estilo
• ppt/media/ - Imagens e outros arquivos de mídia

Extração de tipografia e cores

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

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

Criando uma nova apresentação PowerPoint sem um modelo

Ao criar uma nova apresentação PowerPoint do zero, use o fluxo de trabalho 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: Sobre o que é esta apresentação? Que tom, indústria ou clima ela sugere?
2. Verifique a identidade visual: Se o usuário mencionar uma empresa/organização, considere suas cores e identidade visual
3. Combine a paleta com o 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 informada pelo conteúdo ANTES de escrever código
• ✅ Use apenas fontes seguras para web: Arial, Helvetica, Times New Roman, Georgia, Courier New, Verdana, Tahoma, Trebuchet MS, Impact
• ✅ Crie uma hierarquia visual clara através de tamanho, peso e cor
• ✅ Garanta legibilidade: contraste forte, texto com tamanho adequado, alinhamento limpo
• ✅ Seja consistente: repita padrões, espaçamento e linguagem visual entre os slides

Seleção de Paleta de Cores

Escolhendo cores criativamente:

• Pense além do padrão: Quais cores combinam genuinamente com este tópico específico? Evite escolhas automáticas.
• Considere múltiplos ângulos: Tópico, indústria, clima, nível de energia, público-alvo, identidade visual (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 de 3 a 5 cores que funcionem juntas (cores dominantes + tons de suporte + destaque)
• Garanta contraste: O texto deve ser claramente legível sobre os fundos

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

1. Azul Clássico: Azul marinho escuro (#1C2833), cinza ardósia (#2E4053), prata (#AAB7B8), off-white (#F4F6F6)
2. Verde-azulado & Coral: Verde-azulado (#5EA8A7), verde-azulado escuro (#277884), coral (#FE4447), branco (#FFFFFF)
3. Vermelho Ousado: Vermelho (#C0392B), vermelho vivo (#E74C3C), laranja (#F39C12), amarelo (#F1C40F), verde (#2ECC71)
4. Blush Quente: Malva (#A49393), blush (#EED6D3), rosa (#E8B4B8), creme (#FAF7F2)
5. Luxo Borgonha: Borgonha (#5D1D2E), carmesim (#951233), ferrugem (#C15937), dourado (#997929)
6. Roxo & Verde Esmeralda: Roxo (#B165FB), azul escuro (#181B24), verde 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. Lima & Ameixa: Lima (#C5DE82), ameixa (#7C3A5F), coral (#FD8C6E), azul-cinza (#98ACB5)
10. Preto & Dourado: Dourado (#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), dourado (#DEB600)
16. Terra Vintage: Mostarda (#E3B448), sálvia (#CBD18F), verde floresta (#3A6B35), creme (#F4F1DE)
17. Rosa Costeiro: Rosa antigo (#AD7670), castor (#B49886), casca de ovo (#F3ECDC), cinza (#BFD5BE)
18. Laranja & Turquesa: Laranja claro (#FC993E), turquesa acinzentado (#667C6F), branco (#FCFCFC)

Opções de Detalhes Visuais

Padrões Geométricos:

• Divisores de seção diagonais em vez de horizontais
• Larguras de coluna assimétricas (30/70, 40/60, 25/75)
• Cabeçalhos de texto rotacionados a 90° ou 270°
• Molduras circulares/hexagonais para imagens
• Formas de acento triangulares nos cantos
• Formas sobrepostas para profundidade

Tratamentos de Borda e Moldura:

• Bordas grossas de cor única (10-20pt) em apenas um lado
• Bordas de linha dupla com cores contrastantes
• Suportes de canto em vez de molduras completas
• Bordas em forma de L (superior+esquerdo ou inferior+direito)
• Acentos de sublinhado abaixo dos cabeçalhos (3-5pt de espessura)

Tratamentos Tipográficos:

• Contraste extremo de tamanho (títulos de 72pt vs corpo de 11pt)
• Cabeçalhos em maiúsculas com amplo espaçamento entre letras
• Seções numeradas em tipo de exibição superdimensionado
• Monoespaçada (Courier New) para dados/estatísticas/conteúdo técnico
• Fontes condensadas (Arial Narrow) para informações densas
• Texto contornado para ênfase

Estilização de Gráficos e Dados:

• Gráficos monocromáticos com uma única cor de destaque para dados-chave
• Gráficos de barras horizontais em vez de verticais
• Gráficos de pontos em vez de gráficos de barras
• Grade mínima ou nenhuma grade
• Rótulos de dados diretamente nos elementos (sem legendas)
• Números superdimensionados para métricas-chave

Inovações de Layout:

• Imagens de sangria total com sobreposições de texto
• Coluna lateral (largura de 20-30%) para navegação/contexto
• Sistemas de grade modular (blocos 3×3, 4×4)
• Fluxo de conteúdo em padrão Z ou padrão F
• Caixas de texto flutuantes sobre formas coloridas
• Layouts de várias colunas estilo revista

Tratamentos de Fundo:

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

Dicas de Layout

Ao criar slides com gráficos ou tabelas:

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

Fluxo de Trabalho

1. OBRIGATÓRIO - LEIA O 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 obter sintaxe detalhada, regras de formatação críticas e práticas recomendadas antes de prosseguir com a criação da apresentação.
2. Crie um arquivo HTML para cada slide com dimensões adequadas (por exemplo, 720pt × 405pt para 16:9)
   • Use <p>, <h1>-<h6>, <ul>, <ol> para todo o conteúdo textual
   • 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 no HTML
   • LAYOUT: Para slides com gráficos/tabelas/imagens, use layout de slide inteiro 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 em áreas de espaço reservado usando a API do PptxGenJS
   • Salve a apresentação usando pptx.writeFile()
4. Validação visual: Gere miniaturas e inspecione problemas de layout
   • Crie grade de miniaturas: python scripts/thumbnail.py output.pptx workspace/thumbnails --cols 4
   • Leia e examine cuidadosamente a imagem de miniatura para:
     • Texto cortado: Texto sendo cortado por barras de cabeçalho, formas ou bordas do slide
     • Sobreposição de texto: Texto sobrepondo outro texto ou formas
     • Problemas de posicionamento: Conteúdo muito próximo dos limites do slide ou de outros elementos
     • Problemas de contraste: Contraste insuficiente entre texto e fundos
   • Se problemas forem encontrados, ajuste margens/espaçamento/cores do HTML e regere a apresentação
   • Repita até que todos os slides estejam visualmente corretos

Editando uma apresentação PowerPoint existente

Ao editar slides em uma apresentação PowerPoint existente, você precisa trabalhar com o formato Open XML do Office (OOXML) bruto. Isso envolve descompactar o arquivo .pptx, editar o conteúdo XML e recompactá-lo.

Fluxo de Trabalho

1. OBRIGATÓRIO - LEIA O 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 obter orientação detalhada sobre a estrutura OOXML e fluxos de trabalho de edição antes de qualquer edição de apresentação.
2. Descompacte a apresentação: python ooxml/scripts/unpack.py <arquivo_office> <diretório_saida>
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 quaisquer erros de validação antes de prosseguir: python ooxml/scripts/validate.py <dir> --original <arquivo>
5. Compacte a apresentação final: python ooxml/scripts/pack.py <diretŕio_entrada> <arquivo_office>

Criando uma nova apresentação PowerPoint usando um modelo

Quando você precisa criar uma apresentação que siga o design de um modelo existente, você precisará duplicar e reorganizar os slides do modelo antes de substituir o conteúdo do espaço reservado.

Fluxo de Trabalho

1. Extraia o texto do modelo E crie grade visual de miniaturas:

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

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

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

     # Análise de Inventário do Modelo
     **Total de Slides: [contagem]**
     **IMPORTANTE: Os slides são indexados a partir de 0 (primeiro slide = 0, último slide = contagem-1)**
     
     ## [Nome da Categoria]
     - Slide 0: [código do layout, se disponível] - Descrição/propósito
     - Slide 1: [código do layout] - Descrição/propósito
     - Slide 2: [código do layout] - Descrição/propósito
     [... TODOS os slides devem ser listados individualmente com seu índice ...]
     

   • Usando a grade de miniaturas: Consulte 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 espaços reservados para imagem
     • Consistência de design entre grupos de slides
     • Hierarquia visual e estrutura
   • Este arquivo de inventário é OBRIGATÓRIO para selecionar modelos apropriados na próxima etapa

3. Crie o esboço da apresentação com base no inventário do modelo:

   • Revise os modelos disponíveis da etapa 2.
   • Escolha um modelo de introdução ou título para o primeiro slide. Deve ser um dos primeiros modelos.
   • Escolha layouts seguros e baseados em texto para os outros slides.
   • CRÍTICO: Corresponda a estrutura do layout ao conteúdo real:
     • Layouts de coluna única: Use para narrativa unificada ou tópico único
     • Layouts de duas colunas: Use SOMENTE quando você tem exatamente 2 itens/conceitos distintos
     • Layouts de três colunas: Use SOMENTE quando você tem exatamente 3 itens/conceitos distintos
     • Layouts de imagem + texto: Use SOMENTE quando você tem imagens reais para inserir
     • Layouts de citação: Use SOMENTE para citações reais de pessoas (com atribuição), nunca para ênfase
     • Nunca use layouts com mais espaços reservados do que você tem conteúdo
     • Se você tem 2 itens, não os force em um layout de 3 colunas
     • Se você tem 4+ itens, considere dividir em vários slides ou usar um formato de lista
   • Conte suas peças de conteúdo reais ANTES de selecionar o layout
   • Verifique se cada espaço reservado no layout escolhido será preenchido com conteúdo significativo
   • Selecione uma opção representando o melhor layout para cada seção de conteúdo.
   • Salve outline.md com conteúdo E mapeamento do modelo que aproveite os designs disponíveis
   • Exemplo de mapeamento de modelo:

...