# gt: General Translation CLI tool: SRT URL: https://generaltranslation.com/fr/docs/cli/reference/formats/srt-files.mdx Docs index: https://generaltranslation.com/llms.txt Description: Traduisez des fichiers de sous-titres SubRip avec la CLI de General Translation. Référence de l'API pour le format de fichier SRT. La CLI traduit le texte des sous-titres des fichiers SubRip (`.srt`) tout en conservant les numéros de sous-titres, les horodatages, les séparateurs et le balisage. Cette fonctionnalité nécessite `gt` 2.22.2 ou une version ultérieure. ## Vue d'ensemble [#overview] | Sujet | Description | | --------------------------------------- | ------------------------------------------------------------------------------------------------------------ | | [Configuration](#config) | Faire correspondre les chemins `.srt` source et traduits. | | [Comportement de traduction](#behavior) | Préserver les numéros de sous-titre, les lignes de minutage, les séparateurs et le balisage des sous-titres. | | [Encodage](#encoding) | Décoder et restaurer les encodages de texte avec indicateur d'ordre des octets (BOM). | | [Validation](#validation) | Ignorer les fichiers vides et rejeter les documents dépourvus de sous-titre valide. | ## Configuration [#config] Ajoutez une entrée `srt` sous `files` avec un tableau `include` de motifs glob. Utilisez le placeholder `[locale]` pour que la CLI puisse trouver les fichiers source et enregistrer les traductions dans le chemin correspondant à chaque paramètre régional. ```json title="gt.config.json" { "defaultLocale": "en", "locales": ["es", "fr"], "files": { "srt": { "include": ["subtitles/[locale]/**/*.srt"] } } } ``` Avec cette configuration, les sous-titres source proviennent de `subtitles/en/`, et les sous-titres traduits sont enregistrés dans `subtitles/es/` et `subtitles/fr/`. Utilisez [`transform`](/docs/cli/reference/config#files) pour renommer les chemins de sortie. Le format SRT ne prend en charge que le format de sortie `SRT` : il ne peut pas être converti dans un autre format de fichier avec `transformationFormat`. Consultez la [référence de configuration](/docs/cli/reference/config#files) pour en savoir plus sur les clés de fichiers communes. ## Comportement de traduction [#behavior] Seul le texte des sous-titres est traduit. Le pipeline conserve telles quelles les parties suivantes du document source : * Numéros des sous-titres * Horodatages de début et de fin, y compris les données de position * Lignes vides servant de séparateurs et contenu situé en dehors des sous-titres valides * Balisage des sous-titres, comme ``, ``, `` et ``, ainsi que les tags de position `{\an1}`–`{\an9}` en début de ligne Les lignes traduites reprennent la fin de ligne détectée dans la source de chaque sous-titre, tandis que les séparateurs non traités restent inchangés. Les traductions existantes des sous-titres non modifiés peuvent être réutilisées, sauf si vous forcez la retraduction. ## Encodage [#encoding] La CLI lit les fichiers SRT dépourvus de marque d'ordre des octets (BOM) comme de l'UTF-8. Lorsqu'un fichier commence par une BOM, elle prend en charge l'UTF-8, l'UTF-16 petit-boutiste ou gros-boutiste, ainsi que l'UTF-32 petit-boutiste ou gros-boutiste. Les traductions téléchargées reprennent l'encodage et la BOM du fichier source. Un fichier UTF-16 ou UTF-32 sans BOM est traité comme de l'UTF-8. Ajoutez la BOM appropriée ou enregistrez le fichier en UTF-8 avant de le traduire. ## Validation [#validation] La CLI ignore les fichiers SRT vides et les signale dans le récapitulatif de la commande. L'API exige au moins un sous-titre doté d'une ligne de minutage valide. Les blocs dépourvus de ligne de minutage valide restent inchangés et ne sont pas traduits. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.