# gt: General Translation CLI tool: Configurer la CLI
URL: https://generaltranslation.com/fr/docs/cli/guides/configuring.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Comment configurer un fichier gt.config.json de General Translation avec vos paramètres régionaux, vos fichiers et vos options de stockage.

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 si nécessaire.

```bash
npx gt init
```

Dans un monorepo, exécutez la commande depuis l’application que vous souhaitez localiser, et non depuis la racine du workspace. Pour les applications React avec Vite, l’assistant installe `gt-react`, configure [`initializeGTSPA`](/docs/react/reference/config#initialize-spa) avant le point d’entrée existant de l’application et met en place le chargement des traductions localement ou depuis un CDN.

### 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. La plupart des types acceptent un tableau `include` de motifs glob utilisant l’espace réservé `[locale]` pour repérer les fichiers source et enregistrer les fichiers traduits. Les [catalogues `.xcstrings`](/docs/cli/reference/formats/xcstrings-files) font exception, car tous les paramètres régionaux sont stockés dans un seul fichier mis à jour sur place.

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

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

## 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

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.