# gt: General Translation CLI tool: SRT URL: https://generaltranslation.com/es/docs/cli/reference/formats/srt-files.mdx Docs index: https://generaltranslation.com/llms.txt Description: Traduce archivos de subtítulos SubRip con la CLI de General Translation. Referencia de la API para el formato de archivo SRT. La CLI traduce el texto de los subtítulos en archivos SubRip (`.srt`) y conserva los números de subtítulo, las marcas de tiempo, los separadores y el marcado. Para usar esta función se necesita `gt` 2.22.2 o una versión posterior. ## Descripción general [#overview] | Tema | Descripción | | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------- | | [Configuración](#config) | Empareja las rutas `.srt` de origen con las traducidas. | | [Comportamiento de traducción](#behavior) | Conserva los números de los subtítulos, las líneas de tiempo, los separadores y el marcado de los subtítulos. | | [Codificación](#encoding) | Decodifica y restaura las codificaciones de texto con marca de orden de bytes (BOM). | | [Validación](#validation) | Omite los archivos vacíos y rechaza los documentos que no contienen ningún subtítulo válido. | ## Configuración [#config] Agrega una entrada `srt` dentro de `files` con un array `include` de patrones glob. Usa el marcador de posición `[locale]` para que la CLI pueda localizar los archivos de origen y guardar las traducciones en la ruta de la configuración regional correspondiente. ```json title="gt.config.json" { "defaultLocale": "en", "locales": ["es", "fr"], "files": { "srt": { "include": ["subtitles/[locale]/**/*.srt"] } } } ``` Con esta configuración, los subtítulos de origen se toman de `subtitles/en/` y los subtítulos traducidos se guardan en `subtitles/es/` y `subtitles/fr/`. Usa [`transform`](/docs/cli/reference/config#files) para renombrar las rutas de salida. SRT solo admite `SRT` como formato de salida; no se puede convertir a otro formato de archivo con `transformationFormat`. Consulta la [referencia de configuración](/docs/cli/reference/config#files) para ver las claves de archivo compartidas. ## Comportamiento de la traducción [#behavior] Solo se traduce el texto de los subtítulos. El flujo conserva sin cambios estas partes del documento de origen: * Números de los subtítulos * Marcas de tiempo de inicio y fin, incluidos los datos de posición * Separadores de línea en blanco y el contenido fuera de subtítulos válidos * Marcado de subtítulos como ``, ``, ``, `` y las etiquetas de posición iniciales `{\an1}`–`{\an9}` Las líneas traducidas usan el final de línea detectado en el origen de cada subtítulo, mientras que los separadores que no se modifican se conservan tal cual. Las traducciones existentes de los subtítulos que no han cambiado pueden reutilizarse, salvo que fuerces la retraducción. ## Codificación [#encoding] La CLI lee como UTF-8 los archivos SRT sin marca. Si un archivo comienza con una marca de orden de bytes (BOM), admite UTF-8, UTF-16 little-endian o big-endian, y UTF-32 little-endian o big-endian. Las traducciones descargadas conservan la codificación y la marca de orden de bytes del archivo de origen. Los archivos UTF-16 o UTF-32 sin marca se tratan como UTF-8. Añade la marca de orden de bytes correspondiente o guarda el archivo como UTF-8 antes de traducirlo. ## Validación [#validation] La CLI omite los archivos SRT vacíos y los indica en el resumen del comando. La API requiere al menos un subtítulo con una línea de tiempos válida. Los bloques que no tengan una línea de tiempos válida se mantienen sin cambios y no se traducen. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.