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

title: GT
description: Traduisez des projets gt-next, gt-react et gt-react-native avec General Translation. Référence de l’API du format de fichier gt.

---

Le format de fichier `gt` contient les traductions des projets qui utilisent [`gt-react`, `gt-next` ou `gt-react-native`](/docs/react/overview). Lorsque vous exécutez [`gt translate`](/docs/cli/reference/commands/translate), la CLI analyse votre code source à la recherche de contenu inline — comme les composants [`<T>`](/docs/react/reference/components/t) et les appels à [`useGT`](/docs/react/reference/hooks/use-gt) — ainsi que votre dictionnaire, puis enregistre le résultat dans ce format.

## Configuration [#config]

Ajoutez une entrée `gt` dans `files`. Elle prend en charge un chemin `output` avec l’espace réservé `[locale]` pour enregistrer les traductions localement.

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

Cela enregistre les traductions en français et en espagnol dans `public/i18n/fr.json` et `public/i18n/es.json`, que vous pouvez charger avec [`loadTranslations`](/docs/react/reference/functions/load-translations).

## Options de stockage [#storage]

* **Local :** définissez `output` pour intégrer les traductions à votre application. Il s’agit de la configuration par défaut : avec cette configuration, le CLI ne publie pas sur le CDN.
* **CDN :** omettez `output` et activez la publication pour charger les traductions au moment de l’exécution. Voir [Publication sur le CDN](/docs/cli/reference/config#cdn-publishing).

Actuellement, un seul fichier de sortie peut être généré par paramètre régional.

## Analyse du contenu inline [#parsing]

L’entrée `gt` prend en charge un objet `parsingFlags` qui contrôle la façon dont la CLI analyse le contenu inline. Tous les indicateurs sont désactivés par défaut.

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

* `autoderive` — analyse les interpolated values dans les appels `t()`, `gt()` et `msg()`, ainsi que les expressions à l’intérieur des composants `<T>`, comme si elles étaient encapsulées dans `derive()`, et génère une translation entry distincte pour chaque valeur possible. Accepte `true` ou un objet tel que `{ "jsx": true, "strings": false }`. Voir [Traductions autoderive](/docs/cli/guides/using-autoderive).
* `enableAutoJsxInjection` — encapsule le texte JSX traduisible dans des composants `<T>` au build, afin que vous n’ayez pas à les ajouter manuellement. Voir [Injection JSX automatique](/docs/cli/guides/using-auto-jsx).
* `includeSourceCodeContext` — inclut les lignes de code source environnantes comme contexte supplémentaire pour chaque traduction. Remplace la key obsolète de niveau supérieur `files.gt.includeSourceCodeContext`.
* `legacyGtReactImportSource` — fait en sorte que les imports `gt-react` injectés par le compiler soient résolus vers `gt-react/browser`, pour les projets qui ont besoin de l’ancien chemin d’import.