# gt: General Translation CLI tool: gt stage
URL: https://generaltranslation.com/it/docs/cli/reference/commands/stage.mdx
Docs index: https://generaltranslation.com/llms.txt
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, [`gt translate`](/docs/cli/reference/commands/translate) scarica solo le versioni messe in staging. Se non è stata messa in staging alcuna versione, viene completata senza scaricare file. 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 versioni precedentemente messe 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`, [`translate`](/docs/cli/reference/commands/translate) scarica solo le versioni messe in staging. Se non ci sono versioni messe in staging, viene completato senza scaricare file. Scarica le traduzioni completate con [`gt download`](/docs/cli/reference/commands/download), oppure usa [`gt translate`](/docs/cli/reference/commands/translate).

## 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 caricare o mettere in coda le traduzioni.                                                                                                       | `boolean`  | Sì          | `false`          |
| `--save-local, --no-save-local` | Abilita o disabilita il salvataggio delle modifiche locali prima della messa in coda. Ha la precedenza su [`options.saveLocal`](/docs/cli/reference/config#save-local). | `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).

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.