Constructeur de sous-titres trilingues (TH / EN / ZH)
Une vidéo courte avec des sous-titres en trois langues peut toucher des spectateurs qui ne regarderaient jamais une voix qu'ils ne comprennent pas. Mais de mauvais sous-titres sont pires que pas de sous-titres du tout : des lignes désynchronisées, des phrases coupées en plein milieu, ou du chinois qui ressemble à une traduction automatique donnent à la vidéo un aspect amateur. Cette compétence produit trois fichiers SRT qui partagent exactement les mêmes timings, se lisent naturellement et tiennent sur un écran de téléphone.
Le script fourni scripts/make_srt.py (bibliothèque standard Python uniquement) écrit les fichiers et les vérifie. Utilisez-le quand vous pouvez exécuter du code ; sinon, suivez les mêmes règles manuellement et affichez le texte SRT dans des blocs de code.
Étape 1 — Obtenir le texte source avec timings
Déterminez ce que l'utilisateur a, par ordre de préférence :
- Un transcript avec timestamps (SRT/VTT depuis l'application de montage, sous-titres automatiques YouTube, un outil de reconnaissance vocale) → utilisez ses timings. Fusionnez ou divisez les répliques pour que chacune représente une idée unique de 1 à 3,5 secondes.
- Le script final + la durée de la vidéo → divisez le script en répliques (une phrase parlée chacune) et laissez le script estimer les timings avec
--estimate <secondes>. Prévenez l'utilisateur que les timings sont des estimations et doivent être ajustés dans son éditeur pour correspondre à la voix — les sous-titres estimés sont la cause la plus fréquente de « les sous-titres sont décalés ». - Seulement un fichier audio/vidéo → si vous disposez d'un outil de reconnaissance vocale dans cette session, retranscrivez d'abord avec des timestamps par mot. Sinon, dites-le clairement et demandez un export du transcript depuis leur application de montage (la plupart des éditeurs et YouTube Studio peuvent exporter des sous-titres). N'inventez jamais ce qui a été dit.
Gardez la langue source exactement comme elle a été parlée — des sous-titres qui diffèrent de la voix perturbent les spectateurs. Corrigez uniquement les erreurs évidentes de transcription (mots mal entendus, noms de marques) et dites à l'utilisateur lesquelles vous avez corrigées.
Étape 2 — Traduire ligne par ligne
Traduisez chaque réplique séparément afin que les timings restent identiques dans toutes les langues. Règles :
- Parlé, court, naturel. Les sous-titres se lisent en une ou deux secondes. Préférez « Turn it off at night » à « It is recommended that the device be switched off during night-time hours. »
- Le sens prime sur les mots. Les éléments de remplissage thaï (นะครับ, เลย, อ่ะ) disparaissent en anglais/chinois. Les expressions idiomatiques reçoivent un équivalent, pas une copie littérale.
- Gardez les nombres, unités, noms de modèles et noms d'applications identiques dans les trois fichiers, et dans le même format (ex : 80%, 20W, iOS 26). Vérifiez que chaque nombre dans la ligne thaï apparaît aussi dans les lignes EN et ZH.
- Chinois = simplifié (zh-Hans) sauf si l'utilisateur demande le traditionnel (zh-Hant, pour les téléspectateurs de Taïwan/Hong Kong). Utilisez la ponctuation pleine largeur (,。?!). Ne mettez pas d'espaces entre les caractères chinois.
- Étiquettes de menus et texte d'interface à l'écran : utilisez l'étiquette telle qu'elle apparaît réellement dans la version de l'application/téléphone dans cette langue si vous la connaissez ; si vous n'êtes pas sûr de l'étiquette officielle, traduisez de manière descriptive et signalez-le pour que l'utilisateur puisse vérifier sur un appareil réglé dans cette langue.
- Noms de produits/marques, noms de lieux et noms de personnes : conservez la romanisation officielle ; ne traduisez pas les noms de marques en chinois sauf si la marque a un nom chinois officiel dont vous êtes certain.
- N'ajoutez pas d'informations, de plaisanteries ou d'émojis qui ne sont pas dans la voix.
Étape 3 — Écrire le JSON et exécuter le script
{
"langs": ["th", "en", "zh-Hans"],
"segments": [
{"start": 0.0, "end": 2.6, "th": "ชาร์จมือถือข้ามคืน แบตเสื่อมจริงไหม?", "en": "Does charging overnight ruin your battery?", "zh-Hans": "整夜充电会伤电池吗?"},
{"start": 2.7, "end": 6.1, "th": "คำตอบสั้น ๆ คือ ไม่ได้พังทันที แต่ความร้อนคือตัวการ", "en": "Short answer: not instantly, but heat is the real enemy.", "zh-Hans": "简单说:不会马上坏,但真正的敌人是热量。"}
]
}
python3 scripts/make_srt.py segments.json --out-dir subs --name clip01
# pas encore de timings :
python3 scripts/make_srt.py segments.json --out-dir subs --name clip01 --estimate 38.5
Résultat : subs/clip01.th.srt, subs/clip01.en.srt, subs/clip01.zh-Hans.srt plus un rapport de contrôle qualité.
Sauts de ligne : le script formate les répliques longues sur deux lignes. Le thaï n'a pas d'espaces entre les mots, donc il ne coupe qu'aux espaces que les rédacteurs thaïlandais placent entre les phrases — il ne coupera jamais un mot thaï en deux. Si une réplique thaï est signalée comme trop longue, ajoutez un espace entre les phrases à un endroit où la coupure est naturelle, ou forcez la coupure avec | (espace-pipe-espace), ex : "เปิดโหมดชาร์จ | แบบปรับให้เหมาะสม".
Étape 4 — Corriger chaque message de contrôle qualité (QC)
Le script vérifie, par langue :
| Vérification | Limite par défaut | Pourquoi c'est important |
|---|---|---|
| Caractères par ligne | TH 24 · EN 38 · ZH 15 | Écran vertical ; des lignes plus longues passent sous les boutons like/commentaire |
| Lignes par réplique | 2 | Trois lignes couvrent l'image |
| Vitesse de lecture (car/sec) | TH 17 · EN 20 · ZH 9 | Plus rapide que cela, les spectateurs ne peuvent pas finir de lire |
| Temps à l'écran | ≥ 0,7 s | Les flashs sont illisibles |
| Chevauchements / fin avant début / texte vide | aucun autorisé | Les plateformes rejettent ou affichent mal le fichier |
Corrigez en raccourcissant la traduction (premier choix), en divisant une réplique longue en deux, ou en fusionnant une réplique flash avec sa voisine. Réexécutez jusqu'à obtenir 0 erreur ; quelques avertissements sont OK si vous dites à l'utilisateur de quoi il s'agit. Les limites peuvent être modifiées avec --max-line et --max-cps si le style de l'utilisateur diffère.
Le comptage de caractères thaï ignore les marques de ton et de voyelle qui se trouvent au-dessus ou au-dessous d'une lettre, car elles ne prennent pas de place à l'écran.
Étape 5 — Remettre les fichiers
Donnez à l'utilisateur :
- Les trois fichiers
.srt(ou leur contenu dans des blocs de code si vous ne pouvez pas créer de fichiers). - Un petit tableau des lignes dont vous n'étiez pas sûr (labels UI, argot, noms) pour qu'il puisse vérifier.
- Comment les utiliser :
- YouTube Studio : Sous-titres → choisir la vidéo → Ajouter une langue → Télécharger un fichier → « Avec timing ». Téléchargez un fichier par langue. Définissez d'abord la langue originale de la vidéo.
- Sous-titres incrustés (texte dessiné sur la vidéo) : la plupart des spectateurs de formats courts regardent sans le son, donc incruster la langue principale dans la vidéo et télécharger les autres en SRT est un choix courant. De nombreux éditeurs importent le SRT et le stylisent.
- TikTok / Reels : la prise en charge du téléchargement de fichiers SRT varie selon la version de l'application et la région — s'il n'y a pas d'option de téléchargement, incrustez les sous-titres dans la vidéo dans l'éditeur à la place. Vérifiez la page d'aide actuelle de la plateforme.
Exemple
Utilisateur : « Fais des sous-titres en 3 langues pour une vidéo de 9 secondes » + script :
ชาร์จมือถือข้ามคืน แบตเสื่อมจริงไหม? / คำตอบสั้น ๆ คือ ไม่ได้พังทันที แต่ความร้อนคือตัวการ / เปิดโหมดชาร์จแบบปรับให้เหมาะสม ในตั้งค่าแบตเตอรี่
Ce que vous faites : trois répliques → traduire → exécuter avec --estimate 9 → le contrôle qualité prévient que la réplique thaï 3 a une ligne de 26 caractères (เปิดโหมดชาร์จแบบปรับให้เหมาะสม, limite 24). Forcer une coupure n'aiderait pas ici (la deuxième ligne deviendrait trop longue), donc raccourcissez le sous-titre : "เปิดโหมดถนอมแบต ในตั้งค่าแบตเตอรี่". Un sous-titre peut être un peu plus court que la ligne parlée tant que le sens est le même ; si le style de l'utilisateur est de coller mot à mot, demandez avant de raccourcir. Réexécutez : 0 erreur, 1 avertissement (timings estimés). Remettez les trois fichiers et dites : « les timings sont estimés à partir de la longueur du texte — ajustez-les dans votre éditeur pour correspondre à votre voix ; vérifiez le nom anglais/chinois du réglage de la batterie sur un téléphone réglé dans cette langue ».
Résultat de clip01.th.srt :
1
00:00:00,000 --> 00:00:02,653
ชาร์จมือถือข้ามคืน
แบตเสื่อมจริงไหม?
2
00:00:02,653 --> 00:00:06,347
คำตอบสั้น ๆ คือ ไม่ได้พังทันที
แต่ความร้อนคือตัวการ
3
00:00:06,347 --> 00:00:09,000
เปิดโหมดถนอมแบต
ในตั้งค่าแบตเตอรี่