# 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 a General Translation con revisione umana obbligatoria. API Reference del comando gt stage.

---

Invia il tuo Project per la traduzione e mantiene i risultati in attesa della revisione umana invece di scaricarli o pubblicarli. Usalo quando nel tuo Project è abilitata la revisione umana. Per il workflow di revisione, consulta [Gestire le traduzioni](/docs/cli/guides/managing-translations#review).

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. Dopo l'approvazione delle traduzioni, esegui [`translate`](/docs/cli/reference/commands/translate) per scaricarle.

*Nota: solo per l'uso in Production. 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 e conserva i risultati per la revisione umana invece di scaricarli o pubblicarli.
3. Imposta `stageTranslations: true` nel tuo `gt.config.json`, in modo che le esecuzioni successive richiedano lo staging.

Una volta abilitato `stageTranslations`, eseguire `translate` senza prima aver messo quella versione in stage fa terminare la CLI con un errore. Dopo l'approvazione delle traduzioni, esegui `translate` per scaricarle.

## 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"

# Dopo l'approvazione delle traduzioni, scaricale
npx gt translate
```

## Altre note [#notes]

* `stage` è utile solo se la revisione umana è abilitata per il tuo Project.
* 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).