yctrrr/academic-ppt-template

Modelo de PowerPoint Acadêmico

Crie decks acadêmicos editáveis a partir de evidências de pesquisa, preservando o sistema visual integrado e os portões de validação.

Fluxo de Trabalho Obrigatório

1. Leia references/style-spec.md antes de criar slides.
2. Leia references/slide-patterns.md ao selecionar layouts ou planejar um deck.
3. Inspecione assets/academic-template.pptx para a referência renderizada e scripts/create-example.js para a implementação inicial.
4. Crie um gerador específico para o conteúdo fora do diretório da habilidade. Importe componentes de assets/template-kit/; não sobrescreva o ativo de referência.
5. Use apenas números e afirmações suportados pela fonte. Rotule dados ilustrativos explicitamente e remova-os dos decks de pesquisa finais.
6. Gere um .raw.pptx com texto, formas, gráficos e setas de linha nativos do PowerPoint.
7. Execute o validador multiplataforma:

python scripts/validate-pptx.py output.raw.pptx --expected-slides N --expected-charts C --min-arrows A

8. Antes de publicar um template reutilizável ou público, execute a auditoria de privacidade. Adicione termos sensíveis específicos do projeto com argumentos --deny repetidos:

python scripts/audit-privacy.py CAMINHO --deny "termo sensível"

A auditoria de privacidade rejeita imagens, PDFs, fontes e binários do Office legados por padrão, pois a varredura de texto não pode provar que são anônimos. Use --allow-binary-assets somente após inspecionar manualmente cada um desses ativos.

9. No Windows com o Microsoft PowerPoint instalado, feche todas as janelas do PowerPoint e certifique o arquivo final:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/finalize-with-powerpoint.ps1 `
  -InputPath output.raw.pptx `
  -OutputPath output.pptx

10. Renderize e inspecione cada slide. Verifique estouro, sobreposições, setas incorretas, baixo contraste e rótulos de gráfico ausentes.

Status de Certificação

• Relate Validação multiplataforma aprovada após o sucesso de validate-pptx.py.
• Relate Certificado pelo PowerPoint somente quando o finalizador exibir POWERPOINT_OPEN_VALIDATION=PASSED.
• Em sistemas que não sejam Windows ou sistemas sem PowerPoint, mantenha o arquivo bruto e declare explicitamente que a certificação nativa do PowerPoint não foi executada.

Regras de Conteúdo

• Use títulos de ação que declarem a conclusão.
• Mantenha uma tarefa analítica por slide.
• Use preto para texto explicativo do corpo.
• Mantenha gráficos, rótulos de dados, eixos e legendas em Microsoft YaHei.
• Use a família roxa consistentemente para caixas de pares e séries.
• Conecte setas às bordas dos nós e preserve a direção pretendida.
• Não adicione notas do apresentador, instruções de produção visíveis, metadados pessoais ou logotipos de instituições, a menos que o usuário os solicite explicitamente.
• Não invente valores de pesquisa, citações, afiliações ou conclusões.

Recursos Inclusos

• assets/template-kit/ppt-template.js: tema, tipografia, cartões, cabeçalhos e opções de gráfico.
• assets/template-kit/academic-research-flow.js: slide de fluxo acadêmico fixo de quatro nós.
• assets/template-kit/flow-charts.js: setas nativas ancoradas e nós de fluxo.
• assets/academic-template.pptx: deck de referência de seis slides seguro para privacidade.
• scripts/create-example.js: gerador inicial portátil.
• scripts/validate-pptx.py: verificações de ZIP/XML, fonte por execução, nota, gráfico visível e seta.
• scripts/audit-privacy.py: varredura de privacidade de origem e arquivo.
• scripts/finalize-with-powerpoint.ps1: reparo do PowerPoint no Windows, sanitização de metadados e certificação de segunda abertura.

Instale a única dependência Node a partir da raiz da habilidade quando necessário:

npm install