Roteiro explicativo
Um roteiro é uma lista curta de cenas. Cada cena tem uma ou mais linhas de narração e um visual. Ele é escrito para um espectador que está rolando com o som desligado, então cada linha também deve funcionar como legenda.
Duração
- 30-60 s, com o objetivo de 45 s (
targetSecondsemsrc/settings.ts). - Isso equivale a cerca de 75-140 palavras faladas em EN. Conte-as. O espanhol é cerca de 15-20% mais longo para o mesmo conteúdo.
Estrutura
- Gancho, nos primeiros 3 s. A descoberta surpreendente ou uma pergunta concreta. Nunca "Neste vídeo...", "Hoje quero falar sobre..." ou uma saudação. Cartão de introdução.
- Configuração. O que estava sendo testado e por que isso importa, em uma ou duas linhas.
- O experimento em uma imagem. O mecanismo ou design como um visual (um fluxo, uma comparação). Uma ideia, não a seção de métodos inteira.
- A descoberta, com seu número exato. O número como o artigo o escreve ("14/20 vs 4/20", "83%", "p = 0,0018"): mesmo arredondamento, mesmas unidades.
- E daí. O que a descoberta significa para alguém que está construindo com ela, sem ser mais forte do que o artigo afirma.
- Linha do cartão de encerramento: "Mais em javieraguilar.ai" (ES: "Más en javieraguilar.ai").
Voz
- Primeira pessoa, como o artigo é escrito: "Eu dei ao planejador...", "O que eu descobri...".
- Afirmações tão matizadas quanto o artigo. Mantenha suas ressalvas ("nessas execuções", "nesta configuração").
- Frases faladas curtas. Uma ideia por linha. Sem jargões que o artigo não explique.
Legendas
- As legendas são incorporadas a partir do texto da narração, no máximo duas linhas de ~32 caracteres.
- No máximo 17 caracteres por segundo na tela (
npm run lintverifica isso). Uma linha que é lida muito rápido precisa de menos palavras, não de uma voz mais rápida. - Escreva os números na legenda como o artigo faz. Se o TTS deve dizê-los de forma diferente,
dê à linha uma forma falada (veja o skill
narration); nunca altere a legenda por isso. - Evite URLs longas e identificadores de código na narração; eles quebram mal e são difíceis de ler.
EN e ES
- Escreva o par EN/ES junto, linha por linha, para que ambos os cortes permaneçam sincronizados. ES é opcional: deixe o texto ES vazio enquanto um vídeo for apenas em EN.
- A linha ES diz a mesma coisa, não uma tradução palavra por palavra; mantenha-a tão curta quanto a EN.
Visual por cena
Cada cena recebe uma ideia visual, mapeada para um componente da biblioteca (veja
explainer-animation):
| Ideia visual | Componente |
|---|---|
| Uma figura principal contando para cima | Counter |
| Dois a cinco valores lado a lado | BarCompare |
| Um pipeline, uma transferência, um link quebrado | FlowDiagram |
| A frase na qual o artigo se apoia | KeyQuote |
| Duas a quatro figuras de uma vez | StatGrid |
| Gancho e encerramento | cartões intro / outro |
Se nenhum componente se encaixar, marque a cena como "sob medida" com uma descrição de uma linha da animação. Evite um vídeo que seja apenas texto sobre um gradiente: cada artigo recebe pelo menos um visual que mostre seu mecanismo.
Formato do roteiro
Escreva script.md como uma tabela, uma linha por linha de narração:
| Cena | Componente | Linha EN | Linha ES | Visual | Frase de origem |
|---|
- "Frase de origem" cita o artigo para cada número e cada afirmação na linha.
- Termine com a contagem de palavras (EN) e a duração estimada.
- Apresente-o para aprovação antes que qualquer coisa seja construída.