# gt: General Translation CLI tool: gt stage
URL: https://generaltranslation.com/it/docs/cli/reference/commands/stage.mdx
---

title: gt stage
description: Invia un progetto per la traduzione asincrona e scaricalo successivamente. API Reference del comando gt stage.

---

Invia il tuo progetto per la traduzione asincrona senza scaricare o pubblicare i risultati nella stessa esecuzione. Usalo quando nel tuo progetto è abilitata la revisione umana o quando un formato come Lottie non può essere completato in una singola esecuzione di [`gt translate`](/docs/cli/reference/commands/translate). Per entrambi i workflow, consulta [Gestire le traduzioni](/docs/cli/guides/managing-translations).

L'esecuzione di `stage` imposta `stageTranslations: true` nel tuo `gt.config.json`. Una volta abilitata, l'esecuzione di [`gt translate`](/docs/cli/reference/commands/translate) senza prima aver messo in staging una determinata versione fa terminare la CLI con un errore. Quando le traduzioni sono pronte—e approvate quando è richiesta una revisione—esegui [`gt download`](/docs/cli/reference/commands/download). [`gt translate`](/docs/cli/reference/commands/translate) può anche scaricare una versione precedentemente messa in staging.

*Nota: solo per l'uso in produzione. Richiede un `GT_API_KEY` e un `GT_PROJECT_ID` di produzione.*

```bash
npx gt stage
```

## Come funziona [#how-it-works]

1. Legge `gt.config.json`, analizza il codice sorgente alla ricerca di contenuti inline nei progetti basati su framework e raccoglie i file, proprio come fa [`gt translate`](/docs/cli/reference/commands/translate).
2. Invia il contenuto all'API di General Translation senza scaricare o pubblicare i risultati nella stessa esecuzione. I progetti soggetti a revisione conservano le traduzioni completate in attesa di approvazione.
3. Imposta `stageTranslations: true` nel tuo `gt.config.json`, in modo che le esecuzioni successive richiedano lo staging.

Una volta abilitato `stageTranslations`, eseguire [`translate`](/docs/cli/reference/commands/translate) senza prima aver messo quella versione in stage fa terminare la CLI con un errore. Scarica le traduzioni completate con [`gt download`](/docs/cli/reference/commands/download), oppure usa [`gt translate`](/docs/cli/reference/commands/translate) per qualsiasi versione precedentemente messa in staging.

## Flag [#flags]

`stage` accetta gli stessi flag di [`gt translate`](/docs/cli/reference/commands/translate#flags), inclusi i flag di scansione del codice sorgente per i progetti basati su framework. Di seguito sono riportati quelli usati più comunemente; il riferimento riportato sopra contiene l'elenco completo.

| Parametro                   | Descrizione                                                                                               | Tipo       | Facoltativo | Predefinito      |
| --------------------------- | --------------------------------------------------------------------------------------------------------- | ---------- | ----------- | ---------------- |
| `--api-key <key>`           | Chiave API di produzione.                                                                                 | `string`   | Sì          | `GT_API_KEY`     |
| `--project-id <id>`         | ID progetto.                                                                                              | `string`   | Sì          | `GT_PROJECT_ID`  |
| `-c, --config <path>`       | Percorso del file di configurazione.                                                                      | `string`   | Sì          | `gt.config.json` |
| `--locales <locales...>`    | Ulteriori impostazioni regionali di destinazione, aggiunte a quelle della configurazione.                 | `string[]` | Sì          | —                |
| `--default-locale <locale>` | Impostazione regionale sorgente del progetto.                                                             | `string`   | Sì          | `en`             |
| `--dry-run`                 | Analizza e valida senza chiamare l&#39;API.                                                               | `boolean`  | Sì          | `false`          |
| `--tag [value]`             | Etichetta l&#39;esecuzione; se non viene specificato alcun valore, viene ricavato automaticamente da git. | `string`   | Sì          | —                |
| `-m, --message <message>`   | Messaggio associato al tag di traduzione.                                                                 | `string`   | Sì          | —                |

## Esempio [#example]

```bash
# Prepara le traduzioni per la revisione umana
npx gt stage

# Prepara ed etichetta l'esecuzione per il tracciamento nel dashboard
npx gt stage --tag v2.1.0 -m "Q3 release"

# Quando le traduzioni sono pronte, scaricale
npx gt download
```

## Altre note [#notes]

* Usa `stage` quando la revisione umana è abilitata o quando traduci formati asincroni come [Lottie](/docs/cli/reference/formats/lottie-files).

- L&#39;esecuzione di `stage` imposta la chiave di configurazione [`stageTranslations`](/docs/cli/reference/config#stage). Vedi [Preparare le traduzioni per la revisione](/docs/cli/guides/managing-translations#review).