Criação, edição e análise de PPTX
Visão Geral
Um usuário pode pedir para você criar, editar ou analisar 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.
Lendo e analisando conteúdo
Extração de texto
Se você precisa apenas ler o conteúdo textual de uma apresentação, converta o documento para markdown:
# Converter documento para markdown
python -m markitdown caminho-para-arquivo.pptx
Acesso raw XML
Você precisa de acesso raw XML 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 raw.
Descompactando um arquivo
python ooxml/scripts/unpack.py <arquivo_office> <diretorio_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 arquivos chave
ppt/presentation.xml- Metadados principais da apresentação e referências de slidesppt/slides/slide{N}.xml- Conteúdo de slides individuais (slide1.xml, slide2.xml, etc.)ppt/notesSlides/notesSlide{N}.xml- Notas do apresentador para cada slideppt/comments/modernComment_*.xml- Comentários para slides específicosppt/slideLayouts/- Modelos de layout para slidesppt/slideMasters/- Modelos de slide mestreppt/theme/- Informações de tema e estiloppt/media/- Imagens e outros arquivos de mídia
Extração de tipografia e cores
Quando receber um exemplo de design para emular: Sempre analise a tipografia e as cores da apresentação primeiro usando os métodos abaixo:
- Leia o arquivo de tema: Verifique
ppt/theme/theme1.xmlpara cores (<a:clrScheme>) e fontes (<a:fontScheme>) - Amostra de conteúdo de slide: Examine
ppt/slides/slide1.xmlpara uso real de fontes (<a:rPr>) e cores - Pesquise por padrões: Use grep para encontrar cores (
<a:solidFill>,<a:srgbClr>) e referências de 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 para 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:
- Considere o assunto: Sobre o que é esta apresentação? Que tom, indústria ou clima ela sugere?
- Verifique a identidade visual: Se o usuário mencionar uma empresa/organização, considere suas cores e identidade de marca
- Combine a paleta com o conteúdo: Selecione cores que reflitam o assunto
- Declare sua abordagem: Explique suas escolhas de design antes de escrever o código
Requisitos:
- ✅ Declare sua abordagem de design baseada no conteúdo ANTES de escrever o 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: forte contraste, texto com tamanho apropriado, 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 dos padrões: Quais cores realmente combinam 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 da 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 funcionam juntas (cores dominantes + tons de suporte + cor de destaque)
- Garanta contraste: O texto deve ser claramente legível sobre os fundos
Exemplos de paletas de cores (use estes para estimular a criatividade - escolha um, adapte-o ou crie o seu próprio):
- Azul Clássico: Azul marinho profundo (#1C2833), ardósia (#2E4053), prata (#AAB7B8), off-white (#F4F6F6)
- Verde-azulado & Coral: Verde-azulado (#5EA8A7), verde-azulado profundo (#277884), coral (#FE4447), branco (#FFFFFF)
- Vermelho ousado: Vermelho (#C0392B), vermelho brilhante (#E74C3C), laranja (#F39C12), amarelo (#F1C40F), verde (#2ECC71)
- Blush quente: Malva (#A49393), blush (#EED6D3), rosa (#E8B4B8), creme (#FAF7F2)
- Luxo Borgonha: Borgonha (#5D1D2E), carmesim (#951233), ferrugem (#C15937), dourado (#997929)
- Roxo profundo & Esmeralda: Roxo (#B165FB), azul escuro (#181B24), esmeralda (#40695B), branco (#FFFFFF)
- Creme & Verde Floresta: Creme (#FFE1C7), verde floresta (#40695B), branco (#FCFCFC)
- Rosa & Roxo: Rosa (#F8275B), coral (#FF574A), rosa (#FF737D), roxo (#3D2F68)
- Lima & Ameixa: Lima (#C5DE82), ameixa (#7C3A5F), coral (#FD8C6E), azul-cinza (#98ACB5)
- Preto & Dourado: Dourado (#BF9A4A), preto (#000000), creme (#F4F6F6)
- Sálvia & Terracota: Sálvia (#87A96B), terracota (#E07A5F), creme (#F4F1DE), carvão (#2C2C2C)
- Carvão & Vermelho: Carvão (#292929), vermelho (#E33737), cinza claro (#CCCBCB)
- Laranja Vibrante: Laranja (#F96D00), cinza claro (#F2F2F2), carvão (#222831)
- Verde Floresta: Preto (#191A19), verde (#4E9F3D), verde escuro (#1E5128), branco (#FFFFFF)
- Arco-íris Retrô: Roxo (#722880), rosa (#D72D51), laranja (#EB5C18), âmbar (#F08800), dourado (#DEB600)
- Terroso Vintage: Mostarda (#E3B448), sálvia (#CBD18F), verde floresta (#3A6B35), creme (#F4F1DE)
- Rosa Costeiro: Rosa velho (#AD7670), castor (#B49886), casca de ovo (#F3ECDC), cinza cinza (#BFD5BE)
- 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 triangulares de destaque nos cantos
- Formas sobrepostas para profundidade
Tratamentos de Borda & 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
- Molduras em L (superior+esquerda ou inferior+direita)
- Acentos de sublinhado abaixo dos cabeçalhos (3-5pt de espessura)
Tratamentos Tipográficos:
- Contraste extremo de tamanho (72pt para títulos vs 11pt para corpo)
- Cabeçalhos em CAIXA ALTA com espaçamento amplo entre letras
- Seções numeradas em tipos de exibição superdimensionados
- Monoespaçada (Courier New) para dados/estatísticas/conteúdo técnico
- Fontes condensadas (Arial Narrow) para informações densas
- Texto contornado para ênfase
Estilo de Gráficos & 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
- Grades mínimas ou nenhuma
- 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 (20-30% de largura) para navegação/contexto
- Sistemas de grade modular (3×3, 4×4 blocos)
- Fluxo de conteúdo em padrão Z ou F
- Caixas de texto flutuantes sobre formas coloridas
- Layouts de múltiplas colunas estilo revista
Tratamentos de Fundo:
- Blocos de cor sólida ocupando 40-60% do slide
- Preenchimentos gradientes (apenas verticais ou diagonais)
- Fundos divididos (duas cores, diagonal ou vertical)
- Faixas de cor de borda a borda
- 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 que abranja toda a largura, depois duas colunas abaixo - texto/marcadores em uma coluna e o conteúdo destacado na outra. Isso proporciona 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 destacado (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 baixa legibilidade e problemas de layout
Fluxo de trabalho
- OBRIGATÓRIO - LEIA O ARQUIVO INTEIRO: Leia
html2pptx.mdcompletamente 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 críticas de formatação e melhores práticas antes de prosseguir com a criação da apresentação. - Crie um arquivo HTML para cada slide com dimensões adequadas (ex.: 720pt × 405pt para 16:9)
- Use
<p>,<h1>-<h6>,<ul>,<ol>para todo o conteúdo de texto - Use
class="placeholder"para áreas onde gráficos/tabelas serão adicionadas (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
- Use
- Crie e execute um arquivo JavaScript usando a biblioteca
html2pptx.jspara 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 às áreas de placeholder usando a API PptxGenJS
- Salve a apresentação usando
pptx.writeFile()
- Use a função
- 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 de 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 regenere a apresentação
- Repita até que todos os slides estejam visualmente corretos
- Crie grade de miniaturas:
Editando uma apresentação PowerPoint existente
Ao editar slides em uma apresentação PowerPoint existente, você precisa trabalhar com o formato raw Office Open XML (OOXML). Isso envolve descompactar o arquivo .pptx, editar o conteúdo XML e recompactá-lo.
Fluxo de trabalho
- 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. - Descompacte a apresentação:
python ooxml/scripts/unpack.py <arquivo_office> <diretorio_saida> - Edite os arquivos XML (principalmente
ppt/slides/slide{N}.xmle arquivos relacionados) - 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> - Compacte a apresentação final:
python ooxml/scripts/pack.py <diretorio_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 placeholder.
Fluxo de trabalho
-
Extraia o texto do modelo E crie uma grade visual de miniaturas:
- Extraia texto:
python -m markitdown modelo.pptx > modelo-conteudo.md - Leia
modelo-conteudo.md: Leia o arquivo inteiro para entender o conteúdo da apresentação modelo. NUNCA defina limites de intervalo ao ler este arquivo. - Crie grades de miniaturas:
python scripts/thumbnail.py modelo.pptx - Veja a seção Criação de Grades de Miniaturas para mais detalhes
- Extraia texto:
-
Analise o modelo e salve o inventário em um arquivo:
- Análise Visual: Revise as 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
modelo-inventario.mdcontendo:# 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 [... CADA slide deve ser listado individualmente com seu índice ...] - Usando a grade de miniaturas: Referencie as miniaturas visuais para identificar:
- Padrões de layout (slides de título, layouts de conteúdo, divisores de seção)
- Locais e contagens de placeholders de imagem
- Consistência de design entre grupos de slides
- Hierarquia visual e estrutura
- Este arquivo de inventário é OBRIGATÓRIO para selecionar modelos apropriados no próximo passo
-
Crie o esboço da apresentação com base no inventário do modelo:
- Revise os modelos disponíveis do passo 2.
- Escolha um modelo de introdução ou título para o primeiro slide. Este deve ser um dos primeiros modelos.
- Escolha layouts seguros e baseados em texto para os outros slides.
- CRÍTICO: Combine a estrutura do layout com o conteúdo real:
- Layouts de coluna única: Use para narrativa unificada ou tópico único
- Layouts de duas colunas: Use APENAS quando você tiver exatamente 2 itens/conceitos distintos
- Layouts de três colunas: Use APENAS quando você tiver exatamente 3 itens/conceitos distintos
- Layouts de imagem + texto: Use APENAS quando você tiver 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 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 múltiplos slides ou usar um formato de lista
- Conte suas peças de conteúdo reais ANTES de selecionar o layout
- Verifique se cada placeholder 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
esboco.mdcom o conteúdo E o mapeamento do modelo que aproveite os designs disponíveis - Exemplo de mapeamento de modelo:
## Slides | Seção | Slide | Layout do Modelo | Descrição do Layout do Modelo | Conteúdo | |-------|-------|------------------|-------------------------------|----------| | Introdução | 1 | Slide de Título | Slide de título com subtítulo | Título: [titulo], Subtítulo: [subtitulo] | | Agendamento | 2 | Slide de Agendamento | Layout de marcadores com cabeçalho | Título: [titulo], Marcadores: [marcadores] |
-
Crie a apresentação final:
- OBRIGATÓRIO - LEIA O ARQUIVO INTEIRO: Leia
ooxml.md(~500 linhas) completamente para obter orientação detalhada sobre duplicação de slides e edição de XML. - Descompacte o modelo:
python ooxml/scripts/unpack.py modelo.pptx dir_modelo/ - Identifique os arquivos de slide de origem no diretório descompactado (
dir_modelo/ppt/slides/) - Duplicate os arquivos descompactados e edite o XML para criar a sequência de slides desejada
- Siga as etapas de edição OOXML conforme descrito na seção de edição, aplicando-as aos slides duplicados
- Atualize
ppt/presentation.xmlpara referenciar todos os slides - CRÍTICO: Valide após cada edição:
python ooxml/scripts/validate.py dir_modelo/ --original modelo.pptx - Compacte:
python ooxml/scripts/pack.py dir_modelo/ resultado.pptx - Validação visual: Execute validação visual:
- Crie grade de miniaturas:
python scripts/thumbnail.py resultado.pptx workspace/thumbnails --cols 4 - Leia e examine cuidadosamente a imagem de miniatura
- Verifique se os placeholders foram preenchidos corretamente e o texto está posicionado adequadamente
- Se problemas forem encontrados, ajuste o XML e repita
- Crie grade de miniaturas:
- OBRIGATÓRIO - LEIA O ARQUIVO INTEIRO: Leia
Criação de Grades de Miniaturas
Use o script de miniatura para criar uma grade de imagens de todas as miniaturas de slides em uma apresentação:
python scripts/thumbnail.py <arquivo_pptx> [diretorio_saida] [--cols <numero>]
Onde:
<arquivo_pptx>é o caminho para o arquivo da apresentação[diretorio_saida]é opcional (padrão:workspace/thumbnails)--cols <numero>é opcional (padrão: 4 miniaturas por linha)
Nota: O script thumbnail.py está localizado em skills/pptx/scripts/thumbnail.py. Se o script não existir neste caminho, use find . -name "thumbnail.py" para localizá-lo.
Criando ou editando um arquivo .pptx não PowerPoint
Às vezes, um usuário pedirá para você criar ou editar um arquivo .pptx que não é uma apresentação PowerPoint. Isso inclui:
- Slides individuais como imagens
- Imagens de slide como PNG ou JPEG usando o slide como moldura
- Vídeos no formato de slide
- Animações
- GIFs
Para qualquer uma dessas tarefas, crie um arquivo HTML que imite a aparência desejada e converta para PowerPoint usando html2pptx. Este é um método confiável que funciona para todos esses formatos alternativos, pois as imagens de slide, animações e vídeos são simplesmente imagens da interface do slide.
Se você não tem certeza de como criar um desses formatos alternativos, siga o workflow de criação de apresentação (etapas 1-3) para criar uma apresentação funcional primeiro.