Livin21/scripting-explainer-shorts

Scripting explicateurs courts

Présentation

Un explicateur ne vaut que par son affirmation la plus faible. Chaque phrase factuelle et chaque nombre affiché à l’écran doit provenir d’une source que vous avez réellement ouverte. Une accroche qui semble géniale est généralement la phrase la moins vraie du brouillon : vérifiez-la d’abord et réécrivez-la si elle échoue.

Processus

1. Vérifiez l’accroche en premier. Trouvez une source primaire (un organisme de normalisation, un fabricant, une agence gouvernementale, une université ou un code source publié) qui l’énonce. Ensuite :

   • Elle échoue : réécrivez-la d’après ce que dit la source. « Les rayures ne sont pas le nombre » est devenu « le code-barres ne connaît pas le prix » ; « une particule de métal radioactif » est devenu « quelque chose de radioactif » (c’est un oxyde, trop petit pour être vu).
   • Elle tient avec une nuance : conservez-la, ajustez les mots pour correspondre à la source, et intégrez la nuance dans un temps (« ne cuit pas de l’intérieur vers l’extérieur » → les ondes chauffent bien environ un pouce de profondeur).
   • Elle n’est prouvable que pour certains cas : restez général, attribuez chaque nombre spécifique à sa source (« par défaut sur Android… », « Windows… »), et enregistrez l’écart comme partiellement vérifié.

2. Recherchez les temps. Ouvrez chaque source plutôt que de vous fier à un extrait de recherche, et citez la ligne qui soutient l’affirmation. Choisissez la source la plus forte qui énonce l’affirmation :

   Rang	Source	Exemple
   1	Organismes de normalisation, spécifications, code source publié	EMVCo, page du catalogue ISO/CEI, NFC Forum, GS1, AOSP
   2	Agences gouvernementales, régulateurs, banques centrales	NRC, EPA, FDA, USDA, Federal Reserve, BCE
   3	Documentation officielle du fabricant	Visa, Mastercard, fiches techniques NXP, Microsoft Learn
   4	Universités, manuels scolaires, articles évalués par les pairs	notes de cours universitaires, articles de conférence
   5	Explicateurs et presse réputés	uniquement si les rangs 1 à 4 ne l’énoncent pas

   Ne citez jamais un miroir ou un ré-hébergement (copies IPFS ou autres copies de Wikipédia, ré-upload de PDF), une ferme de contenu, un blog SEO ou une documentation marketing. Si seul un miroir s’ouvre, trouvez la page originale ou une copie archivée. Wikipédia (ou une copie) peut vous mener à une source : suivez la référence de l’article, ouvrez-la et citez-la.

   • Une page ne s’ouvre pas : essayez un autre récupérateur, puis une copie archivée. Si vous utilisez une archive, étiquetez-la. Si rien ne se charge, atténuez la phrase ou supprimez-la.
   • La source se contredit elle-même ou contredit la physique : énoncez le chiffre correct clairement (« environ cinq pouces ») et montrez le calcul dans sources.md. Notez le chiffre de la source sous « Simplifié intentionnellement ». Exemple : c ÷ 2450 MHz = 12,2 cm ≈ 5 po, et non les 4 po arrondis de l’USDA.
   • Une inférence (vraie par raisonnement, mais aucune source ne l’énonce en une phrase) : marquez-la comme inférence dans sources.md.

3. Rédigez le commentaire (structure ci-dessous).

4. Respectez le budget. Le plafond est 54 × (la cadence en mots par seconde de la voix), tiré du CHANNEL.md du projet ; cela donne environ 140 mots pour une voix à 2,6 mots par seconde. La formule de fin parlée est incluse. Comptez avec wc -w ; un mot avec trait d’union compte pour un mot.

5. Tableau des scènes et empaquetage (voir le modèle dans templates.md).

6. Rédigez sources.md avec le modèle : une ligne par affirmation, y compris tout nombre affiché à l’écran dans les tags ou les lectures, puis « Simplifié intentionnellement » et « Partiellement vérifié ».

Structure du commentaire

1. Accroche (0–3 s) : un fait surprenant mais vrai, dit sur l’objet représenté en entier dès la première image.
2. La révélation : ouvrez l’objet et montrez ce qu’il contient. Si la « chose » est abstraite (une icône, un signal), révélez l’appareil qui la produit (par exemple, la radio du téléphone pour les barres Wi-Fi). Choisissez la vue dessinée pour que la révélation expose l’intérieur, et faites correspondre le verbe au mouvement (« soulevez le capot »).
3. Trois temps : ce qu’il y a à l’intérieur → comment ça marche → ce à quoi personne ne s’attend.
4. Phrase de conclusion : le fait que les gens répètent à un ami.
5. Formule de fin : la phrase fixe de la chaîne.

Écrivez pour l’oreille : phrases courtes, et épelez les nombres comme ils sont prononcés. Ajoutez des notes vocales pour les mots risqués, qui deviendront des ré-épellations dans l’invite TTS.

Tout autre texte

Les tags à l’écran, les descriptions YouTube, les sous-titres et les pages du site ne peuvent énoncer que des affirmations déjà présentes dans sources.md. Ajouter un « petit » fait lors de la rédaction de la copie, c’est ainsi que les erreurs sont publiées.

Erreurs courantes

Erreur	Correction
Conserver une accroche accrocheuse qui est « fondamentalement vraie »	Réécrivez-la d’après ce que dit la source
Répéter une erreur d’arrondi de la source	Vérifiez par rapport à la physique ou une deuxième source ; montrez le calcul
Tags avec des nombres non sourcés	Ajoutez une ligne source pour chaque chiffre à l’écran
148 mots pour une voix lente	Utilisez le rythme mesuré de la voix ; plafonner à 54 × rythme
Supprimer silencieusement une source qui ne s’ouvre pas	Atténuez ou supprimez la phrase ; enregistrez-la comme partiellement vérifiée
Citer un blog de vendeur ou un miroir Wikipédia	Remontez dans le tableau : la spécification, le régulateur, le fabricant