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

Um .pptx é um arquivo ZIP de arquivos XML. Escolha sua abordagem por tarefa:

Scripts

Os caminhos são relativos ao diretório desta habilidade. Todo o resto é Python puro, node ou shell.

Criando com pptxgenjs — "gotchas"

pptxgenjs é pré-instalado — não execute npm install primeiro; escreva o script e require('pptxgenjs') diretamente. Somente se essa exigência falhar: npm install pptxgenjs. O modelo conhece a API; estes são os "footguns":

• Defina pres.layout antes de adicionar slides. A tela padrão é LAYOUT_16x9 = 10" × 5.625", não 13.3" de largura. Coordenadas além da borda são escritas, não limitadas — a forma simplesmente não estará no slide. (LAYOUT_WIDE é 13.3" × 7.5".)
• Cores hexadecimais: nunca #, nunca 8 dígitos. color: "FF0000". Tanto "#FF0000" quanto o alfa embutidos no hexadecimal ("00000020") corrompem o arquivo. Para translucidez: transparency: 0-100 em preenchimentos e imagens, opacity: 0.0-1.0 em sombras — cada um é silenciosamente ignorado no outro.
• pptxgenjs modifica objetos de opção no local (converte valores para EMU no primeiro uso). Nunca compartilhe um objeto shadow/opções entre duas chamadas add* — crie um objeto novo a cada vez.
• A offset da sombra deve ser ≥ 0 — um deslocamento negativo corrompe o arquivo. Para projetar uma sombra para cima, use angle: 270 com um deslocamento positivo.
• letterSpacing é silenciosamente ignorado — a opção real é charSpacing.
• Listas: bullet: true em cada item, nunca um literal • (renderiza marcadores duplos). Defina breakLine: true em cada item do array, exceto o último. Espaçamento de parágrafos com marcadores com paraSpaceAfter, não lineSpacing (lacunas enormes).
• Um new pptxgen() por arquivo de saída — nunca reutilize uma instância.
• rectRadius funciona apenas em ROUNDED_RECTANGLE, não em RECTANGLE.
• Preenchimentos gradientes não são suportados — use uma imagem gradiente como plano de fundo em vez disso.
• Caixas de texto têm preenchimento interno embutido — defina margin: 0 sempre que o texto precisar se alinhar com uma forma, linha ou ícone na mesma coordenada x.
• Notas do orador vão em slide.addNotes("...") (texto simples, uma vez por slide), nunca em uma caixa de texto no slide.
• Mantenha os gráficos nativos. Use addChart() para tudo que o PowerPoint pode criar gráficos (passe um array de {type, data, options} para combos). Para recursos nativos do PowerPoint que a biblioteca não expõe (linhas de tendência, barras de erro), calcule a série extra você mesmo ou pós-processe o OOXML gerado — não recorra a uma imagem renderizada. Apenas tipos de gráficos para os quais o PowerPoint não tem forma nativa (Sankey, rede, chord) vão como imagens.
• Gráficos padrão renderizam crus — sem título, sem rótulos de dados, paleta datada. Defina showTitle + title, showValue: true + dataLabelPosition, chartColors: [...] de sua paleta e silencie a moldura (catAxisLabelColor/valAxisLabelColor, valGridLine: { color, size }, catGridLine: { style: "none" }, showLegend: false para uma única série).
• Em um gráfico de barras ou colunas empilhadas, dataLabelPosition deve ser ctr, inEnd ou inBase. outEnd corrompe o arquivo.

…