# gt: General Translation CLI tool: Gestione delle traduzioni URL: https://generaltranslation.com/it/docs/cli/guides/managing-translations.mdx Docs index: https://generaltranslation.com/llms.txt Description: Come caricare, accodare, scaricare, preparare e sincronizzare le modifiche locali alle traduzioni con la CLI di General Translation. Il comando [`gt translate`](/docs/cli/reference/commands/translate) esegue l'intero flusso di traduzione in un unico passaggio. Quando ti serve un controllo maggiore — ad esempio fasi CI separate o un passaggio di revisione umana — la CLI espone ogni parte di questo flusso come comando autonomo. *Nota: questi comandi richiedono una chiave API di produzione. Imposta `GT_API_KEY` e `GT_PROJECT_ID` come variabili d'ambiente.* ## Suddividi la traduzione tra le fasi della CI [#split] In una pipeline di CI spesso vuoi caricare i contenuti, tradurli e scaricare i risultati in job separati. Tre comandi coprono queste fasi. 1. [`gt upload`](/docs/cli/reference/commands/upload) carica i file sorgente (e le eventuali traduzioni esistenti) sulla piattaforma. 2. [`gt enqueue`](/docs/cli/reference/commands/enqueue) mette in coda i file caricati per la traduzione e restituisce subito il controllo, senza attendere i risultati. 3. [`gt download`](/docs/cli/reference/commands/download) scarica le traduzioni completate e le salva nei percorsi definiti nella tua configurazione. ```bash # Fase 1: carica i file sorgente npx gt upload # Fase 2: accoda le traduzioni npx gt enqueue # Fase 3: scarica quando pronto npx gt download ``` Poiché [`enqueue`](/docs/cli/reference/commands/enqueue) non aspetta il completamento, puoi eseguire [`download`](/docs/cli/reference/commands/download) in un job successivo quando le traduzioni sono pronte. In questo modo eviti di lasciare aperto un job di build mentre viene eseguita la traduzione. ## Tradurre le animazioni Lottie [#lottie] Le traduzioni Lottie prevedono l'elaborazione asincrona del layout, quindi [`gt translate`](/docs/cli/reference/commands/translate) non può inviarle e scaricarle in un'unica esecuzione. Prepara le animazioni, quindi scarica le impostazioni regionali completate: ```bash npx gt stage npx gt download ``` Se alcune impostazioni regionali sono ancora in fase di elaborazione, il download le salta. Esegui di nuovo [`gt download`](/docs/cli/reference/commands/download) in un secondo momento; il file preparato rimane in `gt-lock.json` finché non vengono scaricate tutte le impostazioni regionali configurate. Consulta il [riferimento al formato Lottie](/docs/cli/reference/formats/lottie-files) per informazioni su configurazione, font e limitazioni delle espressioni. ## Prepara le traduzioni per la revisione [#review] Se il tuo progetto usa la revisione umana, usa [`gt stage`](/docs/cli/reference/commands/stage) per inviare il lavoro di traduzione senza scaricare né pubblicare i risultati nella stessa esecuzione. I progetti soggetti a revisione trattengono le traduzioni completate in attesa di approvazione. ```bash npx gt stage ``` L'esecuzione di [`stage`](/docs/cli/reference/commands/stage) imposta `stageTranslations: true` nel file `gt.config.json`. Dopo l'approvazione delle traduzioni, esegui [`gt download`](/docs/cli/reference/commands/download). Anche [`gt translate`](/docs/cli/reference/commands/translate) può scaricare versioni precedentemente preparate con `stage`. Quando `stageTranslations` è abilitato, [`translate`](/docs/cli/reference/commands/translate) scarica solo le versioni che hai preparato con `stage`. Se non è stato preparato nulla con `stage`, termina senza scaricare file. ## Salva le modifiche locali [#save-local] Quando tu o un traduttore modificate manualmente i file di traduzione scaricati, usa [`gt save-local`](/docs/cli/reference/commands/save-local) per inviare nuovamente queste modifiche alla piattaforma. ```bash npx gt save-local ``` Il comando confronta i file locali con le ultime versioni scaricate, calcola un diff per ogni modifica e lo invia. Non accoda nuove traduzioni. Per eseguire questo passaggio automaticamente prima che [`gt translate`](/docs/cli/reference/commands/translate) o [`gt stage`](/docs/cli/reference/commands/stage) accodino nuovo lavoro, passa `--save-local` oppure imposta [`options.saveLocal`](/docs/cli/reference/config#save-local) su `true` in `gt.config.json`. Per i file Apple `.strings` e `.stringsdict` e per i file Android `strings.xml`, la piattaforma valida e salva l'intero documento modificato. Per `.xcstrings`, la CLI tiene traccia e invia ogni impostazione regionale separatamente, anche se tutte le impostazioni regionali sono memorizzate nello stesso file. ## Next steps - /docs/cli/guides/generating-translations - /docs/cli/guides/branching - /docs/cli/guides/configuring - /docs/cli/guides/using-autoderive ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.