# gt: General Translation CLI tool: Guida rapida
URL: https://generaltranslation.com/it/docs/cli/quickstart.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Usa la CLI di General Translation per tradurre il tuo progetto dalla riga di comando.

La CLI di General Translation (`gt`) configura l'internazionalizzazione e traduce il tuo progetto dalla riga di comando.

Funziona con [`gt-react`, `gt-next` e `gt-react-native`](/docs/react/overview), con librerie i18n di terze parti come `next-intl` e `i18next`, e con file autonomi come JSON, YAML, Markdown e MDX.

## Cosa fa la CLI [#what-it-does]

La CLI ti offre accesso diretto a:

* **Configurazione iniziale** per installare le dipendenze, integrare il tuo framework e creare un `gt.config.json`.
* **Traduzione** per inviare i contenuti sorgente all'API di General Translation e salvare i risultati nella tua base di codice o sul CDN.
* **Componenti di base per la CI** per caricare, accodare e scaricare le traduzioni in diverse fasi della pipeline.
* **Accesso all'API** per richieste non elaborate autenticate e discovery OpenAPI integrata con [`gt api`](/docs/cli/reference/commands/api).
* **Convalida** per verificare la presenza di errori di traduzione nel progetto senza chiamare l'API.

## Quando usare la CLI [#when-to-use]

Usa la CLI quando vuoi:

* Configurare un nuovo progetto per la traduzione con una procedura guidata.
* Tradurre il tuo progetto come parte di una pipeline di build o CI.
* Tradurre file di contenuto indipendenti senza aggiungere una libreria del framework.
* Tenere le traduzioni sotto controllo di versione insieme ai contenuti sorgente.

## Guida rapida [#quickstart]

Installa `gt`, configura il progetto ed esegui la prima traduzione. È necessario disporre di un progetto esistente con un `package.json` e Node.js 20 o versioni successive installato.

### 1. Installa `gt`

Installa la CLI come dipendenza di sviluppo.

<Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
  <Tab value="npm">
    ```bash
    npm install gt --save-dev
    ```
  </Tab>

  <Tab value="yarn">
    ```bash
    yarn add --dev gt
    ```
  </Tab>

  <Tab value="bun">
    ```bash
    bun add --dev gt
    ```
  </Tab>

  <Tab value="pnpm">
    ```bash
    pnpm add --save-dev gt
    ```
  </Tab>
</Tabs>

### 2. Configura il progetto

Esegui [`gt init`](/docs/cli/reference/commands/init) per rilevare il framework, creare `gt.config.json` e, facoltativamente, configurare un progetto e una chiave di sviluppo. Se per questo passaggio è necessario l&#39;accesso, la procedura guidata lo effettua per te.

```bash
npx gt init
```

In un monorepo, esegui il comando dall&#39;app che vuoi localizzare. Se lo esegui dalla radice dell&#39;area di lavoro, la procedura guidata si interrompe senza modificare alcun file.

<Callout type="warn">
  Senza un terminale, [`gt init`](/docs/cli/reference/commands/init) non pone domande interattive. Se mancano delle risposte, si interrompe prima di modificare i file ed elenca le opzioni da passare; consulta [esecuzioni headless](/docs/cli/reference/commands/init#headless). Per la CI, usa la [Configurazione non interattiva per CI](#ci-setup).
</Callout>

La procedura guidata imposta l&#39;impostazione regionale predefinita e le impostazioni regionali di destinazione, e stabilisce dove archiviare le traduzioni. Può anche scrivere una chiave di sviluppo e l&#39;ID progetto in `.env.local`. Consulta [`gt init`](/docs/cli/reference/commands/init) per il comando completo.

*Nota: ora dovresti avere un file `gt.config.json` nella radice del progetto. Con la configurazione Vite che archivia le traduzioni localmente nel bundle puoi saltare l&#39;accesso e le credenziali; completa il passaggio successivo prima di tradurre.*

### 3. Verifica le credenziali

Il comando [`translate`](/docs/cli/reference/commands/translate) richiede un ID progetto e il tuo login salvato oppure una chiave API. Se la configurazione iniziale li ha ignorati, esegui [`gt login`](/docs/cli/reference/commands/login) e imposta l&#39;ID progetto:

```bash title=".env.local"
GT_PROJECT_ID=your-project-id
```

(Vedi [Credenziali della CLI](/docs/cli/guides/configuring#credentials)).

### 4. Traduci il tuo progetto

Esegui il comando [`translate`](/docs/cli/reference/commands/translate) per tradurre tutti i file configurati in `gt.config.json`, insieme a eventuali componenti inline [`<T>`](/docs/react/reference/components/t) e alle voci del dizionario nel codice sorgente.

```bash
npx gt translate
```

Le traduzioni vengono salvate nella tua base di codice, pronte per il commit. Esegui questo comando nella tua pipeline CI prima della build di produzione. Consulta [Generating translations](/docs/cli/guides/generating-translations) per il workflow completo.

## Configurazione non interattiva per CI [#ci-setup]

In CI, configura il progetto manualmente: esegui il commit di un `gt.config.json`, fornisci le credenziali come variabili d&#39;ambiente ed esegui [`translate`](/docs/cli/reference/commands/translate) con tale configurazione.

### 1. Aggiungi un `gt.config.json`

Scrivi il file manualmente ed esegui il commit, così la CLI saprà cosa tradurre. Una configurazione minima imposta l&#39;impostazione regionale sorgente e quelle di destinazione, oltre a una voce `files`, in modo che [`translate`](/docs/cli/reference/commands/translate) abbia qualcosa su cui lavorare. La voce `gt` qui sotto memorizza localmente, nel percorso indicato, le traduzioni del framework (da `gt-next`, `gt-react` o `gt-react-native`).

```json title="gt.config.json"
{
  "$schema": "https://assets.gtx.dev/config-schema.json",
  "defaultLocale": "en",
  "locales": ["fr", "es"],
  "files": {
    "gt": {
      "output": "public/_gt/[locale].json"
    }
  }
}
```

Per tradurre invece file autonomi, aggiungi un tipo di file come `json` o `mdx` con un pattern `include` al posto della voce `gt` (o accanto a essa). Consulta [Configurare la CLI](/docs/cli/guides/configuring) per le opzioni relative a file e archiviazione, e il [riferimento della configurazione](/docs/cli/reference/config) per tutti i campi.

### 2. Imposta le tue credenziali

Imposta la chiave API del progetto e l&#39;ID progetto come variabili d&#39;ambiente nelle impostazioni dei secret del tuo provider CI, non in un file versionato. Crea la chiave nella [Dashboard](/docs/platform/dashboard/reference/api-keys) o con [`gt api-key create`](/docs/cli/reference/commands/api-key-create), concedendo le autorizzazioni **Files &gt; Write** e **Translation queue &gt; Enabled** (aggiungi **Context &gt; Write** se generi il contesto); la chiave di sviluppo creata dalla procedura guidata non basta.

```bash
GT_API_KEY=your-api-key
GT_PROJECT_ID=your-project-id
```

### 3. Esegui il comando translate

Esegui [`translate`](/docs/cli/reference/commands/translate) prima della build di produzione. Passa `--config` per specificare il file di configurazione.

```bash
npx gt translate --config gt.config.json
```

## Next steps

- /docs/cli/guides/generating-translations
- /docs/cli/guides/configuring
- /docs/cli/guides/managing-translations
- /docs/cli/guides/using-auto-jsx

## Sitemap

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