# gt: General Translation CLI tool: Generazione delle traduzioni
URL: https://generaltranslation.com/it/docs/cli/guides/generating-translations.mdx
---

title: Generazione delle traduzioni
description: "Come tradurre il tuo progetto con la CLI di General Translation: questa guida illustra come generare le traduzioni e salvarle nella tua base di codice o sul CDN."
related:
  links:
    - /docs/cli/guides/managing-translations
    - /docs/cli/guides/branching
    - /docs/cli/guides/configuring
    - /docs/cli/guides/using-autoderive

---

Il comando [`gt translate`](/docs/cli/reference/commands/translate) è il modo principale per tradurre il tuo progetto. Legge `gt.config.json` per individuare i file, analizza il codice sorgente alla ricerca di contenuto inline e genera le traduzioni tramite l'API di traduzione di General Translation.

*Nota: esegui [`translate`](/docs/cli/reference/commands/translate) nella pipeline CI prima della build per la produzione. Non è pensato per lo sviluppo, dove invece si usa una chiave API di sviluppo per la traduzione su richiesta.*

## Prima di iniziare [#before]

* Configura il progetto con un `gt.config.json`. Consulta [Configurare la CLI](/docs/cli/guides/configuring).
* Imposta `GT_API_KEY` e `GT_PROJECT_ID` di produzione come variabili d'ambiente.
* Fai checkout del branch da cui esegui la build di produzione.

## Traduci il tuo progetto [#translate]

Esegui il comando dalla radice del progetto.

```bash
npx gt translate
```

La CLI traduce tutti i file corrispondenti in `gt.config.json`. Se usi `gt-next`, `gt-react` o `gt-react-native`, analizza anche il codice sorgente alla ricerca di contenuti inline — come i componenti [`<T>`](/docs/react/reference/components/t) e le chiamate [`useGT`](/docs/react/reference/hooks/use-gt) — e include il file del dizionario. Le traduzioni vengono salvate nella tua base di codice, pronte per il commit.

Se usi `next-intl`, `react-i18next` o `next-i18next`, la CLI rileva la libreria dal tuo `package.json` e traduce i file preservando la sintassi delle stringhe della libreria.

## Aggiungilo alla build [#build]

Esegui `translate` prima del comando di build, così la versione in produzione includerà sempre le traduzioni aggiornate.

```json title="package.json"
{
  "scripts": {
    "translate": "npx gt translate",
    "build": "npm run translate && <your build command>"
  }
}
```

## Controllare quali contenuti vengono tradotti [#content]

Per impostazione predefinita, la CLI cerca i contenuti inline in `src`, `app`, `pages` e `components`. Puoi modificare questo comportamento con il campo `src` in `gt.config.json` o con il flag `--src`.

```bash
npx gt translate --src "lib/**/*.{ts,tsx}"
```

Per tradurre in ulteriori impostazioni regionali in una singola esecuzione senza modificare la configurazione, usa `--locales`. Queste si aggiungono ai locales in `gt.config.json`.

```bash
npx gt translate --locales de it
```

## Validare senza tradurre [#validate]

Passa `--dry-run` per analizzare e validare il progetto senza chiamare l&#39;API. È utile per intercettare errori nella CI prima di un&#39;esecuzione effettiva.

```bash
npx gt translate --dry-run
```

## Ritraduci il contenuto esistente [#retranslate]

Per impostazione predefinita, la CLI traduce solo il contenuto la cui sorgente è cambiata e mantiene le modifiche locali. Per modificare questo comportamento:

* `--force` ritraduce tutto il contenuto e sovrascrive le traduzioni esistenti. Le modifiche locali vengono perse e ti vengono addebitate le nuove traduzioni.
* `--force-download` riscarica le traduzioni e sovrascrive le modifiche locali senza ritradurre.

```bash
npx gt translate --force
```

## Etichettare un&#39;esecuzione di traduzione [#tagging]

Usa `--tag` e `-m` per etichettare un&#39;esecuzione con un identificatore facilmente leggibile, così da rendere più semplice tenere traccia delle versioni nel Dashboard.

```bash
npx gt translate --tag v2.1.0 -m "Added checkout page translations"
```

Passa `--tag` senza specificare alcun valore per usare l&#39;attuale commit hash di Git come tag e il messaggio del commit come messaggio associato. Il tagging non è bloccante: se fallisce, l&#39;esecuzione della traduzione continua.

## Pubblica sul CDN [#publish]

Per impostazione predefinita, le traduzioni vengono salvate localmente. Aggiungi `--publish` per pubblicarle anche sul CDN di General Translation, così da poterle caricare a runtime.

```bash
npx gt translate --publish
```

*Nota: abilita prima il CDN nelle impostazioni del progetto. Senza, il comando viene eseguito e la traduzione va a buon fine, ma il passaggio di pubblicazione fallisce con un avviso.*
## Next steps

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