RinDig/lecture-deck

Deck de palestra

Uma afirmação por tela, uma imagem que mostra o mecanismo, uma legenda e todo o resto nas notas. O deck é construído a partir de módulos Python de tela contra um tema, renderizado em PNG para verificação e verificado quanto ao registro antes de sair.

Quando receber uma solicitação

1. Pergunte ou deduza a sala: quem, quantos, onde, quanto tempo, o que eles já sabem, quem fala e quem gerencia a sala. Se existir um roteiro de apresentação (cronograma do apresentador), aceite-o como dado.
2. Escreva storyboard.md primeiro, usando reference/storyboard-template.md. Objetivo, argumento como afirmações numeradas, roteiro de apresentação com modos e, em seguida, uma entrada por tela com sua imagem e sua transição. Leia os cabeçalhos sozinhos como um argumento; depois as transições sozinhas. Corrija a ordem aqui.
3. Para qualquer coisa com mais de dez telas, critique o storyboard antes de construir (fluxo, nível do público, se cada imagem explica sua afirmação, cobertura do briefing). Incorpore as alterações.
4. Estruture e construa as telas (reference/workflow.md, reference/kit-api.md). Para um deck longo, divida as telas em módulos e construa-os em paralelo.
5. Renderize cada tela e olhe para cada folha de contato. Corrija estouro, corte, texto ilegível, imagens que decoram em vez de explicar.
6. Execute a verificação de registro com --dump e leia o texto simples. Corrija, re-renderize o que mudou, repita até ficar limpo.
7. Entregue o HTML, nomeie o que é placeholder (datas, nomes, uma plataforma que pode não estar pronta) e diga como apresentá-lo (setas, N, O, B, F, Imprimir).

As regras que o tornam bom

• A regra de carga. O cabeçalho é a afirmação. Uma imagem. No máximo uma legenda. Notas de rodapé apenas para citações verificadas. Indicações apenas em telas de exercício e logística. A profundidade vai para DIGA e SE A SALA ESTIVER ADIANTADA, palavra por palavra.
• Imagens mostram mecanismos. Uma imagem que poderia estar sob qualquer cabeçalho é decoração. Desenhe a coisa real: o chat, o arquivo, a pasta, a pessoa se curvando, as lixeiras enchendo. Construa-a na ordem em que o palestrante falará, com anim, draw, grow, rise, slide_in, drop. Complexo é bom quando explica.
• Um elenco. Use figure, machine, rigid para cada pessoa, sistema e caixa rígida, para que o público encontre os mesmos desenhos em todo o deck.
• Papéis, não cores. HIGHLIGHT é o assunto e agora; COOL o sistema; WARM o que está escrito; SOFT a outra parte; NEUTRAL as lacunas; LIVE apenas o ponto do modo. Qualquer tema então funciona.
• A barra de modo. Cada tela começa com mode(kind, label, who): slides, compartilhar, breakout, solo, handoff, intervalo. O público sempre sabe quem tem a tela; o palestrante sempre sabe quando trocar de aplicativos ou passar a palavra. A barra de roteiro de apresentação usa as mesmas cores.
• Registro. Abra na afirmação, frases completas, explique em vez de performar. Sem linhas de revelação, sem "não X mas Y" além de um por deck, sem fragmentos que concluem um ponto, sem tríades forçadas, sem travessões, sem palavras genéricas de IA, sem vocabulário de método em telas de público. Apenas citações verificadas. Exemplos, um por segmento de público, mesma ordem sempre. Detalhes em reference/writing.md.
• As notas são a palestra. DIGA na voz do palestrante, FAÇA AGORA com tempos para o apresentador, PROCURE POR, SE ESTIVER PRESO, SE A SALA ESTIVER ADIANTADA e uma TRANSIÇÃO que leva ao próximo cabeçalho.
• Verifique no tamanho real. O modo estático do renderizador mostra cada elemento animado em seu estado final. Falhas invisíveis em um painel do navegador aparecem em 1280×720.

Comandos

python scripts/new_deck.py path/to/deck --title "Sessão um" --theme eduba --left "PROGRAMA" --right "SESSÃO 1"
python scripts/build_deck.py path/to/deck            # escreve deck/out/<nome>.html
python scripts/build_deck.py path/to/deck --theme slate   # um segundo arquivo em outro tema
python scripts/render.py path/to/deck/out/<nome>.html     # PNG por tela + folhas de contato, modo estático
python scripts/check_text.py path/to/deck/out/<nome>.html --dump

Requisitos: Python 3.9+, um Chromium para renderização (Playwright's, Chrome ou Edge; ou defina DECK_CHROME), Pillow para folhas de contato. Fontes carregam do Google Fonts na abertura; o tema carrega uma pilha de fallback.

Arquivos

• scripts/deckkit/kit.py os helpers, constantes, elenco, imagens comuns. scripts/deckkit/shell.py o shell da página. scripts/deckkit/themes/*.json os temas.
• reference/workflow.md o loop · reference/writing.md o registro · reference/kit-api.md todos os helpers · reference/themes.md papéis e como fazer um tema · reference/storyboard-template.md.
• examples/demo/ um deck de nove telas que exercita a maior parte do kit; construa-o em cada tema para ver a variedade.