# gt: General Translation CLI tool: Configurer la CLI
URL: https://generaltranslation.com/fr/docs/cli/guides/configuring.mdx
---

title: Configurer la CLI
description: "Comment configurer le fichier gt.config.json de General Translation : ce guide explique comment définir vos paramètres régionaux, vos fichiers et vos options de stockage."
related:
  links:
    - /docs/cli/guides/generating-translations
    - /docs/cli/guides/managing-translations
    - /docs/cli/guides/using-auto-jsx
    - /docs/cli/guides/branching

---

La CLI lit un fichier `gt.config.json` à la racine de votre projet pour déterminer ce qui doit être traduit et où les résultats sont enregistrés. Ce guide explique comment créer et modifier ce fichier.

*Remarque : ce guide présente les options de configuration les plus courantes. Pour consulter tous les champs disponibles, reportez-vous à la [référence de configuration](/docs/cli/reference/config).*

## Créer le fichier de configuration [#create]

Vous pouvez créer `gt.config.json` de trois façons. Choisissez celle qui convient le mieux à votre workflow.

### a) Exécuter l’assistant de configuration complet

Exécutez [`gt init`](/docs/cli/reference/commands/init) pour détecter votre framework, installer les dépendances, créer le fichier de configuration et générer les identifiants en une seule commande.

```bash
npx gt init
```

### b) Créez uniquement le fichier de configuration

Exécutez [`gt configure`](/docs/cli/reference/commands/configure) pour créer `gt.config.json` sans installer de dépendances ni modifier la configuration de votre framework.

```bash
npx gt configure
```

### c) Créez-le manuellement

Créez vous-même le fichier et ajoutez la référence `$schema` pour activer la validation et l’autocomplétion dans l’éditeur.

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

## Définissez vos paramètres régionaux [#locales]

Définissez `defaultLocale` comme la langue dans laquelle votre contenu source est rédigé, et renseignez vos langues cibles dans `locales`.

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

Ils utilisent tous deux des codes de langue standard tels que `en`, `en-US` ou `zh`. Consultez [les paramètres régionaux pris en charge](/docs/platform/dashboard/reference/supported-locales) pour obtenir la liste complète.

Pour utiliser un alias personnalisé pour un paramètre régional — par exemple `cn` au lieu de `zh` — ajoutez une entrée `customMapping` qui pointe vers le code officiel.

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

## Choisissez les fichiers à traduire [#files]

Ajoutez un objet `files` avec une clé pour chaque type de fichier que vous souhaitez traduire. Chaque type accepte un tableau `include` de motifs glob utilisant l’espace réservé `[locale]` pour repérer les fichiers source et enregistrer les fichiers traduits.

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

Le CLI remplace `[locale]` par `defaultLocale` lorsqu’il recherche les fichiers source, puis par chaque code de langue cible lorsqu’il enregistre les traductions. Consultez [Formats de fichiers](/docs/cli/reference/formats/gt-jsx-files) pour les options propres à chaque type et [`include`](/docs/cli/reference/config#files) pour les correspondances avancées.

## Choisissez où les traductions sont stockées [#storage]

Si vous utilisez `gt-next`, `gt-react` ou `gt-react-native`, choisissez comment les traductions sont fournies.

* **Enregistrer localement** pour inclure les traductions dans le bundle de votre application. Ajoutez une entrée `gt` avec un chemin `output` qui inclut `[locale]`.
* **Publier sur le CDN** pour charger les traductions au runtime plutôt que de les inclure dans le bundle. Définissez `publish` sur `true`.

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

Voir [la publication sur le CDN](/docs/cli/reference/config#cdn-publishing) pour la configurer globalement, par fichier ou par commande.

## Ajoutez vos identifiants [#credentials]

La commande [`translate`](/docs/cli/reference/commands/translate) nécessite une clé API de production et un ID de projet. Ne les indiquez pas dans `gt.config.json` ; définissez-les plutôt comme variables d’environnement.

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

Exécutez [`gt auth`](/docs/cli/reference/commands/auth) pour les générer et les enregistrer automatiquement dans `.env.local`.
## Next steps

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