# gt: General Translation CLI tool: SRT URL: https://generaltranslation.com/it/docs/cli/reference/formats/srt-files.mdx Docs index: https://generaltranslation.com/llms.txt Description: Traduci i file di sottotitoli SubRip con la General Translation CLI. Riferimento API per il formato di file SRT. La CLI traduce il testo dei cue nei file di sottotitoli SubRip (`.srt`), mantenendo invariati numeri dei cue, timestamp, separatori e markup. Il supporto richiede `gt` 2.22.2 o versione successiva. ## Panoramica [#overview] | Argomento | Descrizione | | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | | [Configurazione](#config) | Associa i percorsi `.srt` sorgente a quelli tradotti. | | [Comportamento della traduzione](#behavior) | Mantiene invariati i numeri dei cue, le righe di temporizzazione, i separatori e il markup dei sottotitoli. | | [Codifica](#encoding) | Decodifica e ripristina le codifiche di testo con byte order mark (BOM). | | [Validazione](#validation) | Ignora i file vuoti e rifiuta i documenti privi di almeno un cue valido. | ## Configurazione [#config] Aggiungi una voce `srt` in `files` con un array `include` di glob pattern. Usa il placeholder `[locale]` affinché la CLI possa individuare i file sorgente e salvare le traduzioni nel percorso dell'impostazione regionale corrispondente. ```json title="gt.config.json" { "defaultLocale": "en", "locales": ["es", "fr"], "files": { "srt": { "include": ["subtitles/[locale]/**/*.srt"] } } } ``` Con questa configurazione, i sottotitoli sorgente provengono da `subtitles/en/`, mentre i sottotitoli tradotti vengono salvati in `subtitles/es/` e `subtitles/fr/`. Usa [`transform`](/docs/cli/reference/config#files) per rinominare i percorsi di output. SRT supporta solo il formato di output `SRT` e non può essere convertito in un altro formato di file con `transformationFormat`. Consulta il [riferimento alla configurazione](/docs/cli/reference/config#files) per le chiavi comuni a tutti i tipi di file. ## Comportamento della traduzione [#behavior] Viene tradotto solo il testo dei cue. La pipeline lascia invariate le seguenti parti del documento sorgente: * Numeri dei cue * Timestamp di inizio e di fine, inclusi i dati di posizionamento * Separatori costituiti da righe vuote e contenuto al di fuori dei cue validi * Markup dei sottotitoli come ``, ``, ``, `` e i tag di posizionamento iniziali da `{\an1}` a `{\an9}` Le righe tradotte usano il carattere di fine riga rilevato nella sorgente del cue, mentre i separatori non interessati dalla traduzione restano invariati. Le traduzioni esistenti dei cue non modificati possono essere riutilizzate, a meno che non si forzi la ritraduzione. ## Codifica [#encoding] La CLI legge i file SRT privi di BOM come UTF-8. Se un file inizia con un byte order mark (BOM), sono supportate le codifiche UTF-8, UTF-16 little-endian o big-endian e UTF-32 little-endian o big-endian. Le traduzioni scaricate mantengono la stessa codifica e lo stesso byte order mark del file sorgente. Un file UTF-16 o UTF-32 privo di BOM viene trattato come UTF-8. Prima della traduzione, aggiungi il byte order mark appropriato oppure salva il file in UTF-8. ## Validazione [#validation] La CLI ignora i file SRT vuoti e li segnala nel riepilogo del comando. L'API richiede almeno un cue con una riga di temporizzazione valida. I blocchi senza una riga di temporizzazione valida restano invariati e non vengono tradotti. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.