Guion explicativo
Un guion es una lista breve de escenas. Cada escena tiene una o más líneas de narración y un elemento visual. Está escrito para un espectador que se desplaza con el sonido apagado, por lo que cada línea también debe funcionar como subtítulo.
Duración
- 30-60 s, apuntando a 45 s (
targetSecondsensrc/settings.ts). - Esto equivale a aproximadamente 75-140 palabras habladas en EN. Cuéntalas. El español suele ser entre un 15 y un 20 % más largo para el mismo contenido.
Estructura
- Gancho, dentro de los primeros 3 s. El hallazgo sorprendente o una pregunta concreta. Nunca "En este video...", "Hoy quiero hablar sobre..." o un saludo. Tarjeta de introducción.
- Contexto. Qué se estaba probando y por qué es importante, en una o dos líneas.
- El experimento en una imagen. El mecanismo o diseño como un solo elemento visual (un flujo, una comparación). Una idea, no la sección completa de métodos.
- El hallazgo, con su número exacto. El número tal como lo escribe el artículo ("14/20 vs 4/20", "83 %", "p = 0.0018"): el mismo redondeo, las mismas unidades.
- Conclusión. Qué significa el hallazgo para alguien que lo utiliza, sin ser más categórico de lo que el artículo afirma.
- Línea de tarjeta de cierre: "Más en javieraguilar.ai" (ES: "Más en javieraguilar.ai").
Voz
- Primera persona, como está escrito el artículo: "Le di al planificador...", "Lo que encontré...".
- Afirmaciones tan matizadas como el artículo. Conserva sus reservas ("en estas ejecuciones", "en esta configuración").
- Frases habladas cortas. Una idea por línea. Sin jerga que el artículo no explique.
Subtítulos
- Los subtítulos se incrustan a partir del texto de narración, con un máximo de dos filas de aproximadamente 32 caracteres.
- Máximo 17 caracteres por segundo en pantalla (
npm run lintlo verifica). Una línea que se lee demasiado rápido necesita menos palabras, no una voz más rápida. - Escribe los números en el subtítulo como lo hace el artículo. Si el TTS debe decirlos de forma diferente, proporciona a la línea una forma hablada (consulta la skill
narration); nunca cambies el subtítulo por ello. - Evita URLs largas e identificadores de código en la narración; se ajustan mal y se leen peor.
EN y ES
- Escribe el par EN/ES junto, línea por línea, para que ambas versiones se mantengan sincronizadas. ES es opcional: deja el texto ES vacío mientras un video sea solo EN.
- La línea ES dice lo mismo, no una traducción palabra por palabra; mantenla tan corta como la EN.
Visual por escena
Cada escena recibe una idea visual, asignada a un componente de la biblioteca (consulta explainer-animation):
| Idea visual | Componente |
|---|---|
| Una cifra principal que cuenta hacia arriba | Counter |
| De dos a cinco valores lado a lado | BarCompare |
| Un pipeline, una transferencia, un enlace roto | FlowDiagram |
| La frase en la que se apoya el artículo | KeyQuote |
| De dos a cuatro cifras a la vez | StatGrid |
| Gancho y cierre | Tarjetas intro / outro |
Si ningún componente encaja, marca la escena como "a medida" con una descripción de una línea de la animación. Evita un video que sea solo texto sobre un degradado: cada artículo obtiene al menos un elemento visual que muestre su mecanismo.
Formato del guion
Escribe script.md como una tabla, una fila por línea de narración:
| Escena | Componente | Línea EN | Línea ES | Visual | Frase fuente |
|---|
- "Frase fuente" cita el artículo para cada número y cada afirmación en la línea.
- Termina con el recuento de palabras (EN) y la duración estimada.
- Preséntalo para su aprobación antes de construir cualquier elemento.