# gt-next: General Translation Next.js SDK: gt.config.json
URL: https://generaltranslation.com/fr/docs/next/api/config/gt-config-json.mdx
---
title: gt.config.json
description: Le fichier gt.config.json
---

{/* GÉNÉRÉ AUTOMATIQUEMENT : ne modifiez pas ce fichier directement. Modifiez plutôt le modèle dans content/docs-templates/. */}


## Vue d’ensemble

Le fichier `gt.config.json` sert à stocker la configuration de votre projet.
Il contient des informations importantes comme le `projectId` de votre projet, les paramètres régionaux pris en charge, etc.
Il contient aussi des informations internes importantes, comme le `versionId` de votre projet.

Ce fichier est lu par (1) votre composant [`<GTProvider>`](/docs/next/api/components/gtprovider) et (2) la commande [`gt translate`](/docs/cli/translate).
C’est pourquoi nous vous recommandons de stocker votre configuration dans votre fichier `gt.config.json` plutôt que de la passer comme prop à votre composant [`<GTProvider>`](/docs/next/api/components/gtprovider).

En général, tout ce qui commence par un trait de soulignement (par ex. `_versionId`) est une propriété interne et ne doit pas être modifié.
Tout le reste peut être modifié.

***

## Champs

| Champ               | Type       | Description                                                                                      |
| ------------------- | ---------- | ------------------------------------------------------------------------------------------------ |
| `projectId`         | `string`   | Identifiant unique de votre projet dans le système GT                                            |
| `locales`           | `string[]` | Tableau des codes de langue pris en charge pour votre projet                                     |
| `defaultLocale`     | `string`   | Code de langue principal utilisé comme solution de repli lorsque des traductions sont manquantes |
| `cacheUrl`          | `string`   | URL du point de terminaison pour la mise en cache des données de traduction                      |
| `runtimeUrl`        | `string`   | URL du point de terminaison pour les services de traduction à l’exécution                        |
| `stageTranslations` | `boolean`  | Configuration des fonctionnalités de traduction pour la préproduction et la prévisualisation     |
| `files`             | `object`   | Chemin vers les fichiers de traduction locaux pour le développement et les tests                 |
| `_versionId`        | `string`   | Propriété interne utilisée pour suivre la version du projet (ne pas modifier)                    |

### `cacheUrl` et `runtimeUrl`

Si vous stockez vos traductions dans le cloud, `cacheUrl` est l’URL de base du cache.
`runtimeUrl` est l’URL de base du service d’exécution et s’applique uniquement aux traductions de développement.

### `stageTranslations`

`stageTranslations` est un indicateur utilisé par l’outil `gt` pour marquer vos traductions comme devant être révisées.
Cela signifie qu’elles doivent être approuvées manuellement avant de pouvoir être déployées en production via la commande [`gt translate`](/docs/cli/translate).

### `files`

Le champ `files` spécifie un chemin vers des traductions stockées localement (par opposition à un stockage dans le cloud).
Plus précisément, le champ `output` indique où les traductions seront enregistrées.

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

Consultez la [documentation de configuration](/docs/cli/reference/config) de l’outil CLI pour en savoir plus sur l’utilisation du champ `files`.


#### `parsingFlags`

L’objet `files.gt.parsingFlags` détermine la façon dont le compilateur analyse vos fichiers source.

| Indicateur               | Type      | Par défaut | Description                                                                                                                                                                                                 |
| ------------------------ | --------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `enableAutoJsxInjection` | `boolean` | `false`    | Enveloppe automatiquement le texte JSX traduisible dans des composants de traduction lors du build. Voir [l’injection automatique de JSX](/docs/cli/features/auto-jsx-injection).                           |
| `autoderive`             | `boolean` | `false`    | Traite automatiquement les valeurs interpolées dans les appels à `t()`, `gt()` et `msg()` comme des appels à [`derive()`](/docs/next/api/strings/derive). Voir [autoderive](/docs/cli/features/autoderive). |

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

{/* 
  ### `_versionId`

  Points à couvrir :
  - interne
  - vous pouvez définir vos propres noms de version */}

***

## Exemples

### Spécifier vos paramètres régionaux

```json title="gt.config.json"
{
  "defaultLocale": "en", // Le paramètre régional principal est l'anglais
  "locales": ["fr", "es"] // Les paramètres régionaux secondaires sont le français et l'espagnol
}
```

{/* ### Spécifier votre versionId personnalisé */}

***


## Remarques

* Le fichier `gt.config.json` sert à définir la configuration de votre projet.
* Il est lu à la fois par le composant [`<GTProvider>`](/docs/next/api/components/gtprovider) et par la commande [`gt translate`](/docs/cli/translate).
* Il doit être placé à la racine de votre projet.

## Étapes suivantes