# gt: General Translation CLI tool: JSON
URL: https://generaltranslation.com/fr/docs/cli/formats/json.mdx
---
title: JSON
description: Comment traduire automatiquement des fichiers JSON avec General Translation
---

## Vue d’ensemble

`gt` peut être utilisé pour traduire automatiquement les fichiers JSON de votre projet, quelle que soit la bibliothèque i18n que vous utilisez.

<Callout type="info">
  **Remarque :** Nous prenons actuellement en charge la syntaxe et le formatage personnalisés des chaînes pour les bibliothèques i18n tierces
  suivantes : `next-intl`, `i18next`. Si vous utilisez une
  autre bibliothèque i18n, les résultats de traduction peuvent ne pas être exacts pour les
  chaînes utilisant une syntaxe ou un formatage personnalisés (par exemple, les messages ICU). Vous ne
  voyez pas votre bibliothèque préférée ? [Faites-le-nous
  savoir](https://github.com/generaltranslation/gt/issues), et nous l’ajouterons dès que
  possible !
</Callout>

Nous allons suivre ces 4 étapes :

<Steps>
  <Step>
    Ajoutez vos variables d’environnement
  </Step>

  <Step>
    Installez [`gt`](/docs/cli)
  </Step>

  <Step>
    Créez un fichier `gt.config.json`
  </Step>

  <Step>
    Exécutez [`gt translate`](/docs/cli/translate#translate)
  </Step>
</Steps>

<Callout>
  **Astuce :**
  Évitez les contraintes liées à l’utilisation de fichiers de traduction grâce au composant [`<T>`](/docs/react/guides/t).
</Callout>

***

## Étape 1 : Ajoutez vos variables d’environnement

Ajoutez votre clé API de production et l’ID de votre projet à vos variables d’environnement.
Cela est nécessaire pour utiliser l’outil `gt`.
Vous pouvez les récupérer dans le [tableau de bord General Translation](https://generaltranslation.com/dashboard).

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


## Étape 2 : Installez `gt`

Installez l’outil `gt` dans votre projet.

<Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
  <Tab value="npm">
    ```bash
    npm i gt
    ```
  </Tab>

  <Tab value="yarn">
    ```bash
    yarn add --dev gt
    ```
  </Tab>

  <Tab value="bun">
    ```bash
    bun add --dev gt
    ```
  </Tab>

  <Tab value="pnpm">
    ```bash
    pnpm add --save-dev gt
    ```
  </Tab>
</Tabs>

## Étape 3 : Créez un fichier `gt.config.json`

Créez un fichier `gt.config.json` à la racine de votre projet.

```json title="gt.config.json" copy
{
  "defaultLocale": "en",
  "locales": ["zh", "es", "ja"],
  "files": {
    "json": {
      "include": ["i18n/[locale]/*.json"]
    }
  }
}
```

N’hésitez pas à personnaliser le fichier `gt.config.json` selon vos besoins. Consultez la documentation de [configuration](/docs/cli/reference/config) pour en savoir plus.

Mettez à jour le format du fichier `json` afin que le chemin `include` corresponde à la structure de votre projet.

<Callout>Les traductions conservent la syntaxe d’origine des chaînes.</Callout>


## Étape 4 : Ajoutez la commande `gt translate` à votre processus de build

Ajoutez la commande `gt translate` à votre processus de build ou à votre pipeline CI avant la commande de build afin d’ajouter automatiquement les traductions à votre projet.

```json title="package.json"
{
  "scripts": {
    "translate": "npx gt translate",
    "build": "npm run translate && <your build command>"
  }
}
```

Cela générera des traductions pour tous vos paramètres régionaux et les enregistrera dans votre projet.
Si vous souhaitez valider ces fichiers dans votre dépôt, vous pouvez exécuter cette commande à la place avant de valider.

C&#39;est terminé ! Votre projet mettra désormais automatiquement à jour tous vos fichiers JSON de traduction à chaque modification du projet.

***


## Métadonnées par clé

Vous pouvez associer à chaque chaîne des instructions de traduction via un fichier `.metadata.json` compagnon. Cela vous permet de fournir du contexte, des limites de caractères et le contexte du code source pour des clés spécifiques sans modifier le fichier source.

```json title="translations.json"
{
  "nav": {
    "home": "Home",
    "bank": "Bank",
    "save": "Save"
  }
}
```

```json title="translations.metadata.json"
{
  "nav": {
    "bank": {
      "context": "Riverbank — the side of a river. NOT a financial institution."
    },
    "save": {
      "context": "Sports term — a goalkeeper preventing a goal. NOT saving data.",
      "maxChars": 12
    }
  }
}
```

Toutes les clés n’ont pas besoin de métadonnées — fournissez uniquement des entrées pour les clés qui nécessitent des instructions de traduction spécifiques.

Consultez la [référence des métadonnées par clé](/docs/cli/reference/keyed-metadata) pour obtenir la liste complète des champs pris en charge.

***


## Remarques

* Vous pouvez ajouter automatiquement des traductions à votre projet avec la commande [`gt translate`](/docs/cli/translate#translate).
* Si vous souhaitez versionner vos fichiers de traduction, exécutez la commande `gt translate` avant de valider.
* Pour configurer le chemin de sortie de vos traductions, consultez la documentation sur la [configuration](/docs/cli/reference/config).

## Prochaines étapes

* Consultez la [commande translate](/docs/cli/translate) pour les détails d’utilisation du CLI.
* Découvrez les [métadonnées par clé](/docs/cli/reference/keyed-metadata) pour définir des instructions de traduction pour chaque clé.