# gt: General Translation CLI tool: Configurazione della CLI
URL: https://generaltranslation.com/it/docs/cli/guides/configuring.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Come impostare un file gt.config.json di General Translation con le impostazioni regionali, i file e le opzioni di archiviazione.

La CLI legge un file `gt.config.json` alla radice del tuo progetto per decidere cosa tradurre e dove salvare i risultati. Questa guida mostra come creare e modificare quel file.

*Nota: questa guida illustra le opzioni di configurazione più comuni. Per ogni campo disponibile, consulta il [riferimento della configurazione](/docs/cli/reference/config).*

## Crea il file di configurazione [#create]

Puoi creare `gt.config.json` in tre modi. Scegli quello più adatto al tuo workflow.

### a) Esegui la procedura guidata di configurazione completa

Esegui [`gt init`](/docs/cli/reference/commands/init) per rilevare il framework, installare le dipendenze, creare il file di configurazione e generare le credenziali quando necessario.

```bash
npx gt init
```

In un monorepo, esegui il comando dall'app che vuoi localizzare, non dalla radice dell'area di lavoro. Per le app React con Vite, la procedura guidata installa `gt-react`, configura [`initializeGTSPA`](/docs/react/reference/config#initialize-spa) prima del punto di ingresso esistente dell'app e imposta il caricamento locale delle traduzioni o tramite CDN.

### b) Crea solo il file di configurazione

Esegui [`gt configure`](/docs/cli/reference/commands/configure) per creare `gt.config.json` senza installare dipendenze né modificare la configurazione del framework.

```bash
npx gt configure
```

### c) Scrivilo a mano

Crea tu stesso il file e aggiungi il riferimento `$schema` per la convalida e il completamento automatico nell'editor.

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

## Imposta le impostazioni regionali [#locales]

Imposta `defaultLocale` sulla lingua in cui sono scritti i contenuti sorgente ed elenca le lingue di destinazione in `locales`.

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["fr", "es", "ja"]
}
```

Entrambi usano codici locale standard come `en`, `en-US` o `zh`. Consulta [impostazioni regionali supportate](/docs/platform/dashboard/reference/supported-locales) per l'elenco completo.

Per usare un alias personalizzato per un'impostazione regionale — ad esempio `cn` invece di `zh` — aggiungi una voce `customMapping` che punti al codice ufficiale.

```json title="gt.config.json"
{
  "customMapping": {
    "cn": { "code": "zh" }
  }
}
```

## Scegli quali file tradurre [#files]

Aggiungi un oggetto `files` con una chiave per ogni tipo di file che vuoi tradurre. La maggior parte dei tipi prevede un array `include` di pattern glob che usano il segnaposto `[locale]` per individuare i file sorgente e salvare quelli tradotti. I [catalog `.xcstrings`](/docs/cli/reference/formats/xcstrings-files) sono l'eccezione, perché ogni impostazione regionale è memorizzata in un unico file che viene aggiornato in-place.

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["fr", "es"],
  "files": {
    "json": {
      "include": ["locales/[locale]/**/*.json"]
    },
    "mdx": {
      "include": ["content/docs/[locale]/**/*.mdx"]
    }
  }
}
```

La CLI sostituisce `[locale]` con `defaultLocale` quando cerca i file sorgente e con ciascun codice di destinazione quando salva le traduzioni. Le opzioni specifiche di ciascun tipo sono documentate in [Formati di file](/docs/cli/reference/formats/gt-jsx-files), mentre i criteri di corrispondenza avanzati sono documentati in [`include`](/docs/cli/reference/config#files).

## Scegli dove salvare le traduzioni [#storage]

Se usi `gt-next`, `gt-react` o `gt-react-native`, scegli come distribuire le traduzioni.

* **Salva localmente** per includere le traduzioni nel bundle della tua app. Aggiungi una voce `gt` con un percorso `output` che includa `[locale]`.
* **Pubblica sulla CDN** per caricare le traduzioni a runtime invece di includerle nel bundle. Imposta `publish` su `true`.

```json title="gt.config.json"
{
  "files": {
    "gt": {
      "output": "public/i18n/[locale].json"
    }
  }
}
```

(Vedi [pubblicazione CDN](/docs/cli/reference/config#cdn-publishing) per gestire la pubblicazione a livello globale, per file o per comando).

## Aggiungi le tue credenziali [#credentials]

Il comando [`translate`](/docs/cli/reference/commands/translate) richiede una chiave API per la produzione e l'ID progetto. Non inserirli in `gt.config.json`; impostali invece come variabili d'ambiente.

```bash title=".env"
GT_API_KEY=your-api-key
GT_PROJECT_ID=your-project-id
```

Esegui [`gt auth`](/docs/cli/reference/commands/auth) per generarli e salvarli automaticamente in `.env.local`.

## Next steps

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

## Sitemap

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