# gt: General Translation CLI tool: Gestione delle traduzioni
URL: https://generaltranslation.com/it/docs/cli/guides/managing-translations.mdx
---
title: Gestione delle traduzioni
description: Come caricare, accodare, scaricare, preparare e sincronizzare le modifiche locali alle traduzioni con la CLI di General Translation.
related:
  links:
    - /docs/cli/guides/generating-translations
    - /docs/cli/guides/branching
    - /docs/cli/guides/configuring
    - /docs/cli/guides/using-autoderive

---

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 una versione precedentemente preparata con `stage`. Quando `stageTranslations` è abilitato, [`translate`](/docs/cli/reference/commands/translate) scarica solo le versioni che hai preparato con `stage`; se non hai preparato nulla con `stage`, termina con un errore.

## 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. [`gt translate`](/docs/cli/reference/commands/translate) esegue questo passaggio di salvataggio per impostazione predefinita prima di accodare nuovo lavoro; passa `--no-save-local` per saltarlo durante un'esecuzione.
## Next steps

- /docs/cli/guides/generating-translations
- /docs/cli/guides/branching
- /docs/cli/guides/configuring
- /docs/cli/guides/using-autoderive