Editorial PPTX Deck
Produza uma apresentação de slides polida e de estilo editorial minimalista e exporte-a para um PPTX editável. O entregável final é apenas o .pptx — os slides HTML são apenas a fonte de construção, e visualizadores PDF/HTML não são produzidos.
Como funciona
Os slides são criados como HTML restrito (um arquivo por slide), e o scripts/html2pptx.js traduz cada elemento DOM em um objeto nativo do PowerPoint (caixas de texto reais, editáveis com duplo clique). O corpo é fixado em 1280px × 720px = 960pt × 540pt (LAYOUT_WIDE).
Fluxo de construção
Copie esta lista de verificação e acompanhe o progresso:
- [ ] 1. Scaffold do projeto (shared/ assets/ slides/ output/)
- [ ] 2. Planejar a narrativa → mapear cada slide a um tipo de template
- [ ] 3. Escrever slides/NN-nome.html a partir dos templates (editar apenas texto)
- [ ] 4. check_overflow → corrigir qualquer slide que não tenha exatamente 1280x720
- [ ] 5. Exportar PPTX (apenas)
- [ ] 6. Limpar fonte de construção (manter apenas o .pptx)
1. Scaffold. No diretório de trabalho do projeto, crie shared/, assets/, slides/, output/. Copie shared/tokens.css deste skill para o diretório shared/ do projeto. Copie apenas as fotos que você usará de assets/ deste skill para o diretório assets/ do projeto. Instale as dependências uma vez:
npm i pptxgenjs playwright sharp && npx playwright install chromium
2. Planejar. Transforme o conteúdo de origem em uma lista de slides. Cada slide é um dos tipos de template. Um deck típico = capa → (divisor → 1–3 slides de conteúdo) × seções → encerramento. Mantenha o texto conciso; este estilo é arejado.
3. Escrever slides. Copie o template mais próximo de templates/ para slides/NN-nome.html e substitua o texto. Regras:
- Mantenha
<link rel="stylesheet" href="../shared/tokens.css">. - Títulos usam a serifada; todo o resto usa sans-serif (já configurado nos tokens).
- Apenas um destaque vermelho. Use o painel escuro (
--ink-panel) com moderação para contraste, com o dourado#C9A24Bcomo seu único destaque. - Fotos são inseridas via
<img>(nuncabackground-image). Veja a biblioteca de fotos.
4. Verificar ajuste. Slides que transbordam são cortados no PPTX:
node scripts/check_overflow.mjs --slides slides
Corrija qualquer item marcado como OVERFLOW (encurte o texto ou ajuste posições) até que todos reportem 1280x720.
5. Exportar PPTX apenas.
node scripts/export_deck_pptx.mjs --slides slides --out output/NomeDoDeck.pptx
Os slides são ordenados por nome de arquivo (01-…, 02-…). Não execute nenhuma exportação para PDF/HTML — o PPTX é o único entregável.
6. Limpar. Apague os HTMLs em slides/ e quaisquer arquivos temporários, de modo que apenas output/NomeDoDeck.pptx permaneça (além de shared/ e assets/ reutilizáveis, se o usuário quiser iterar).
Sistema de design
Definido em shared/tokens.css. Não invente novas cores.
| Token | HEX | Uso |
|---|---|---|
--ink | #1A1A1A | Títulos e corpo principal |
--soft | #555555 | Corpo secundário |
--muted | #8C8C8C | Rótulos, notas, números de página |
--red | #C8102E | O único destaque: barra, antetítulo, palavras-chave, sublinhados |
--red-deep | #A00C24 | Ênfase negativa em tabelas |
--red-pale | #FBE9EC | Chips de conexão (ex.: círculos "→") |
--box | #F4F3F1 | Cartões claros / linhas zebradas |
--line | #E4E2DE | Separadores finos |
--ink-panel | #1C1C1C | Painéis de contraste escuros |
| gold | #C9A24B | Destaque apenas em painéis escuros |
| background | #FFFFFF | Página |
- Tipografia: Georgia serifada para
h*/títulos; Arial/Helvetica sans-serif para todo o resto. - Assinatura: barra vertical vermelha fina à esquerda do título + pequeno antetítulo vermelho com espaçamento entre letras acima; número de página centralizado e pequeno na parte inferior.
- Troca de marca: para se adequar a outra empresa, altere
--red(e opcionalmente--ink-panel/gold) emtokens.css— nada mais.
Biblioteca de fotos
As fotos estão em assets/ deste skill. Imagens em retrato preenchem aproximadamente 40% direito do painel do divisor/capa (object-fit:cover); imagens em paisagem são adequadas para capas com sangria total.
| Arquivo | Orientação | Melhor para |
|---|---|---|
sail.png | retrato 589×1024 | painel direito do divisor/capa (padrão) |
lighthouse-cliff.png | retrato 627×1024 | painel direito do divisor/capa |
staircase.png | alta 312×1024 | faixa de divisor calma/abstrata |
mast.png | estreita 208×1024 | faixa de divisor estreita |
hiker-clouds.png | estreita 225×1024 | faixa de divisor estreita |
lighthouse-sunset.png | paisagem 1024×721 | capa com sangria total / faixa superior |
sailboat-deck.png | paisagem 1024×721 | capa com sangria total / faixa superior |
Troque uma foto alterando <img src="../assets/….png">. Mantenha uma foto (ou um motivo) consistente em todos os divisores para coesão. Os usuários também podem colocar suas próprias imagens em assets/.
Catálogo de templates
Em templates/ (cada um é um slide completo, seguro contra overflow, de 1280×720):
| Arquivo | Tipo |
|---|---|
01-cover.html | Capa dividida: título serifado à esquerda, foto retrato à direita |
02-divider.html | Divisor de seção: antetítulo + título serifado + barra vermelha, foto retrato à direita |
03-three-column.html | Antetítulo/título + linha central + 3 colunas + faixa de resultado |
04-mapping.html | Duas colunas "o que eles querem → o que fazemos" com chips de conexão |
05-compare-table.html | Tabela de comparação de 3 colunas, linhas zebradas |
06-dark-contrast.html | Dois painéis (claro vs escuro) + linha de rodapé serifada |
07-pipeline.html | Pipeline horizontal numerado de etapas + barra de saída escura |
08-closing.html | Argumento de encerramento: linhas serifadas numeradas + foto retrato à direita |
Restrições rígidas
A conversão HTML→PPTX falha ou renderiza incorretamente se estas regras forem quebradas. Detalhes completos + correções em reference.md:
- Texto apenas dentro de
<p>/<h1>–<h6>(nunca texto solto em um<div>). - Sem gradientes CSS.
background/border/box-shadowapenas em<div>, nunca em tags de texto.- Sem
background-image; use<img>. - Tags inline (
span/em/strong) não podem ter margens. - Corpo permanece 1280×720; nada pode transbordar.
