# gt: General Translation CLI tool: GT
URL: https://generaltranslation.com/it/docs/cli/reference/formats/gt-jsx-files.mdx
---

title: GT
description: Traduci i progetti gt-next, gt-react e gt-react-native con General Translation. Riferimento API per il formato di file `gt`.

---

Il formato di file `gt` contiene le traduzioni dei progetti che usano [`gt-react`, `gt-next` o `gt-react-native`](/docs/react/overview). Quando esegui [`gt translate`](/docs/cli/reference/commands/translate), la CLI analizza il codice sorgente alla ricerca di contenuti inline — come i componenti [`<T>`](/docs/react/reference/components/t) e le chiamate a [`useGT`](/docs/react/reference/hooks/use-gt) — insieme al dizionario, e scrive i risultati in questo formato.

## Configurazione [#config]

Aggiungi una voce `gt` in `files`. La voce accetta un percorso `output` con il segnaposto `[locale]` per salvare le traduzioni in locale.

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["fr", "es"],
  "files": {
    "gt": {
      "output": "public/i18n/[locale].json"
    }
  }
}
```

In questo modo, le traduzioni in francese e spagnolo vengono salvate in `public/i18n/fr.json` e `public/i18n/es.json`, che puoi caricare con [`loadTranslations`](/docs/react/reference/functions/load-translations).

## Opzioni di archiviazione [#storage]

* **Locale:** imposta `output` per includere le traduzioni nel bundle della tua app. Questa è l&#39;impostazione predefinita: con questa configurazione, la CLI non pubblica sul CDN.
* **CDN:** ometti `output` e abilita la pubblicazione per caricare invece le traduzioni a runtime. Vedi [pubblicazione CDN](/docs/cli/reference/config#cdn-publishing).

Attualmente può essere generato un solo file di output per ogni impostazione regionale.

## Parsing del contenuto inline [#parsing]

La voce `gt` accetta un oggetto `parsingFlags` che controlla come la CLI analizza il contenuto inline. Tutti i flag sono disattivati per impostazione predefinita.

```json title="gt.config.json"
{
  "files": {
    "gt": {
      "parsingFlags": {
        "autoderive": true,
        "devHotReload": true,
        "enableAutoJsxInjection": true,
        "includeSourceCodeContext": true,
        "legacyGtReactImportSource": false
      }
    }
  }
}
```

* `autoderive` — analizza i valori interpolati nelle chiamate [`t()`](/docs/react/reference/functions/t-function), `gt()` e [`msg()`](/docs/react/reference/functions/msg) e le espressioni all&#39;interno dei componenti [`<T>`](/docs/react/reference/components/t) come se fossero racchiuse in [`derive()`](/docs/react/reference/functions/derive), generando una voce di traduzione separata per ogni valore possibile. Accetta `true` oppure un oggetto come `{ "jsx": true, "strings": false }`. Vedi [Derivazione automatica delle traduzioni](/docs/cli/guides/using-autoderive).
* `devHotReload` — abilita la traduzione runtime per i nuovi contenuti durante lo sviluppo. `true` abilita la traduzione delle stringhe; usa un oggetto come `{ "strings": true, "jsx": true }` per controllare separatamente la gestione delle stringhe e di JSX.
* `enableAutoJsxInjection` — racchiude il testo JSX traducibile nei componenti [`<T>`](/docs/react/reference/components/t) in fase di build, così non devi aggiungerli manualmente. Vedi [Iniezione automatica di JSX](/docs/cli/guides/using-auto-jsx).
* `includeSourceCodeContext` — include le righe di codice sorgente circostanti come contesto aggiuntivo per ogni traduzione. Sostituisce la chiave di primo livello deprecata `files.gt.includeSourceCodeContext`.
* `legacyGtReactImportSource` — fa in modo che gli import inseriti dal compiler vengano risolti come `gt-react/browser`. Abilitalo solo con versioni legacy di `gt-react` che esportano questo percorso; le versioni correnti usano l&#39;import `gt-react` dalla radice.