Script explicatif
Un script est une courte liste de scènes. Chaque scène comporte une ou plusieurs lignes de narration et un visuel. Il est écrit pour un spectateur qui fait défiler la vidéo sans le son, donc chaque ligne doit également fonctionner comme un sous-titre.
Durée
- 30 à 60 secondes, en visant 45 secondes (
targetSecondsdanssrc/settings.ts). - Cela correspond à environ 75 à 140 mots parlés en anglais (EN). Comptez-les. En espagnol (ES), le contenu est environ 15 à 20 % plus long pour le même message.
Structure
- Accroche, dans les 3 premières secondes. Le résultat surprenant ou une question concrète. Jamais « Dans cette vidéo… », « Aujourd'hui, je veux parler de… » ou une formule de politesse. Carte d'introduction.
- Mise en contexte. Ce qui a été testé et pourquoi c'est important, en une ou deux lignes.
- L'expérience en une image. Le mécanisme ou le design sous forme d'un visuel unique (un flux, une comparaison). Une idée, pas toute la section méthode.
- Le résultat, avec son chiffre exact. Le chiffre tel qu'il est écrit dans l'article (« 14/20 contre 4/20 », « 83 % », « p = 0,0018 ») : mêmes arrondis, mêmes unités.
- Conclusion. Ce que le résultat signifie pour quelqu'un qui l'utilise, sans exagérer par rapport aux affirmations de l'article.
- Ligne de carte de fin : « Plus sur javieraguilar.ai » (EN : « More at javieraguilar.ai »).
Voix
- Première personne, comme l'article est rédigé : « J'ai donné au planificateur… », « Ce que j'ai trouvé… ».
- Affirmations aussi nuancées que dans l'article. Conservez ses modalisateurs (« sur ces exécutions », « dans ce contexte »).
- Phrases courtes et parlées. Une idée par ligne. Pas de jargon que l'article n'explique pas.
Sous-titres
- Les sous-titres sont incrustés à partir du texte de narration, au maximum deux rangées d'environ 32 caractères.
- Au maximum 17 caractères par seconde à l'écran (
npm run lintle vérifie). Une ligne qui se lit trop vite a besoin de moins de mots, pas d'une voix plus rapide. - Écrivez les nombres dans le sous-titre comme le fait l'article. Si la synthèse vocale doit les dire différemment, donnez à la ligne une forme parlée (voir la compétence
narration) ; ne modifiez jamais le sous-titre pour cela. - Évitez les URL longues et les identifiants de code dans la narration ; ils s'affichent mal et se lisent encore moins bien.
Anglais et espagnol
- Écrivez la paire EN/ES ensemble, ligne par ligne, afin que les deux versions restent synchronisées. L'ES est facultative : laissez le texte ES vide tant qu'une vidéo est uniquement en EN.
- La ligne ES dit la même chose, pas une traduction mot à mot ; gardez-la aussi courte que l'EN.
Visuel par scène
Chaque scène reçoit une idée visuelle, associée à un composant de la bibliothèque (voir explainer-animation) :
| Idée visuelle | Composant |
|---|---|
| Un chiffre principal qui défile | Counter |
| Deux à cinq valeurs côte à côte | BarCompare |
| Un pipeline, une transmission, un lien cassé | FlowDiagram |
| La phrase sur laquelle repose l'article | KeyQuote |
| Deux à quatre chiffres à la fois | StatGrid |
| Accroche et fermeture | cartes d'intro / de fin |
Si aucun composant ne convient, marquez la scène « bespoke » (sur mesure) avec une description d'une ligne de l'animation. Évitez une vidéo composée uniquement de texte sur un dégradé : chaque article obtient au moins un visuel qui montre son mécanisme.
Format du script
Écrivez script.md sous forme de tableau, une ligne par ligne de narration :
| Scène | Composant | Ligne EN | Ligne ES | Visuel | Phrase source |
|---|
- « Phrase source » cite l'article pour chaque nombre et chaque affirmation dans la ligne.
- Terminez par le nombre de mots (EN) et la durée estimée.
- Présentez-le pour approbation avant que quoi que ce soit ne soit construit.