# gt-next: General Translation Next.js SDK: gt.config.json
URL: https://generaltranslation.com/it/docs/next/api/config/gt-config-json.mdx
---
title: gt.config.json
description: Il file gt.config.json
---

{/* GENERATO AUTOMATICAMENTE: non modificare direttamente. Modifica invece il modello in content/docs-templates/. */}


## Panoramica

Il file `gt.config.json` serve a memorizzare la configurazione del progetto.
Contiene informazioni importanti come il `projectId` del progetto, le impostazioni regionali supportate e altro ancora.
Contiene anche informazioni interne importanti, come il `versionId` del progetto.

Questo file viene letto da (1) il componente [`<GTProvider>`](/docs/next/api/components/gtprovider) e (2) il comando [`gt translate`](/docs/cli/translate).
Per questo motivo, ti consigliamo di salvare la configurazione nel file `gt.config.json` anziché passarla come prop al componente [`<GTProvider>`](/docs/next/api/components/gtprovider).

In generale, tutto ciò che inizia con un trattino basso (ad esempio `_versionId`) è una proprietà interna e non deve essere modificato.
Tutto il resto può essere modificato.

***

## Campi

| Campo               | Tipo       | Descrizione                                                                             |
| ------------------- | ---------- | --------------------------------------------------------------------------------------- |
| `projectId`         | `string`   | Identificatore univoco del tuo progetto nel sistema GT                                  |
| `locales`           | `string[]` | Array dei codici locale supportati dal tuo progetto                                     |
| `defaultLocale`     | `string`   | Codice locale principale usato come fallback quando mancano traduzioni                  |
| `cacheUrl`          | `string`   | Endpoint URL per la cache dei dati di traduzione                                        |
| `runtimeUrl`        | `string`   | Endpoint URL per i servizi di traduzione runtime                                        |
| `stageTranslations` | `boolean`  | Configurazione delle funzionalità di traduzione per staging/anteprima                   |
| `files`             | `object`   | Percorso dei file di traduzione locali per lo sviluppo e i test                         |
| `_versionId`        | `string`   | Proprietà interna usata per tenere traccia della versione del progetto (non modificare) |

### `cacheUrl` and `runtimeUrl`

Se archivi le traduzioni nel cloud, `cacheUrl` è l&#39;URL di base della cache.
`runtimeUrl` è l&#39;URL di base del runtime e si applica solo alle traduzioni in fase di sviluppo.

### `stageTranslations`

`stageTranslations` è un flag usato dallo strumento `gt` per contrassegnare le traduzioni come da revisionare.
Ciò significa che devono essere approvate manualmente prima di poter essere distribuite in produzione tramite il comando [`gt translate`](/docs/cli/translate).

### `files`

Il campo `files` specifica il percorso delle traduzioni archiviate localmente (anziché nel cloud).
In particolare, il campo `output` specifica dove verranno scritte le traduzioni.

```json
{
  "files": {
    "gt": {
      "output": "public/_gt/[locale].json"
    }
  },
}
```

Per ulteriori informazioni su come utilizzare il campo `files`, consulta la [documentazione di configurazione](/docs/cli/reference/config) dello strumento CLI.


#### `parsingFlags`

L&#39;oggetto `files.gt.parsingFlags` controlla il modo in cui il compilatore analizza i file di origine.

| Flag                     | Tipo      | Predefinito | Descrizione                                                                                                                                                                                       |
| ------------------------ | --------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `enableAutoJsxInjection` | `boolean` | `false`     | Avvolge automaticamente il testo JSX traducibile nei componenti di traduzione durante la fase di build. Vedi [auto JSX injection](/docs/cli/features/auto-jsx-injection).                         |
| `autoderive`             | `boolean` | `false`     | Tratta automaticamente i valori interpolati nelle chiamate `t()`, `gt()` e `msg()` come chiamate a [`derive()`](/docs/next/api/strings/derive). Vedi [autoderive](/docs/cli/features/autoderive). |

```json title="gt.config.json"
{
  "files": {
    "gt": {
      "output": "public/_gt/[locale].json",
      "parsingFlags": {
        "enableAutoJsxInjection": true,
        "autoderive": true
      }
    }
  }
}
```

{/* 
  ### `_versionId`

  Punti da evidenziare:
  - interno
  - puoi specificare i nomi delle versioni che preferisci */}

***

## Esempi

### Specifica delle impostazioni regionali

```json title="gt.config.json"
{
  "defaultLocale": "en", // L'impostazione regionale primaria è l'inglese
  "locales": ["fr", "es"] // Le impostazioni regionali secondarie sono il francese e lo spagnolo
}
```

{/* ### Specificare un versionId personalizzato */}

***


## Note

* Il file `gt.config.json` viene utilizzato per specificare la configurazione del progetto.
* Viene letto sia dal componente [`<GTProvider>`](/docs/next/api/components/gtprovider) sia dal comando [`gt translate`](/docs/cli/translate).
* Deve trovarsi nella directory principale del progetto.

## Passaggi successivi