# 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 gestire le traduzioni con la CLI di General Translation: questa guida spiega come suddividere il workflow nelle fasi di upload, enqueue e download, come preparare le traduzioni per la revisione e come sincronizzare le modifiche locali."
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` non aspetta il completamento, puoi eseguire `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.

## Prepara le traduzioni per la revisione [#review]

Se il tuo progetto usa la revisione umana, usa [`gt stage`](/docs/cli/reference/commands/stage) invece di tradurre direttamente. Funziona come [`translate`](/docs/cli/reference/commands/translate), ma invece di scaricare o pubblicare i risultati, li mette in attesa di approvazione.

```bash
npx gt stage
```

L'esecuzione di `stage` imposta `stageTranslations: true` nel file `gt.config.json`. Dopo l'approvazione delle traduzioni, esegui `gt translate` per scaricarle. Quando `stageTranslations` è abilitato, `translate` scarica solo le versioni che hai preparato con `stage`; se non hai preparato nulla con `stage`, non c'è nulla da scaricare.

## 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. Se invece vuoi includere le modifiche locali in un'esecuzione di traduzione, passa `--save-local` a `translate`.
## Next steps

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