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

title: JSON
description: Traduisez des fichiers JSON avec la CLI de General Translation. Référence de l’API pour le format de fichier JSON.

---

La CLI traduit les fichiers JSON, quelle que soit la bibliothèque i18n utilisée. Les traductions conservent la syntaxe d’origine des chaînes.

*Remarque : la syntaxe et le formatage personnalisés des chaînes — par exemple les messages ICU — sont pris en charge pour `next-intl` et `i18next`. Avec d’autres bibliothèques, la traduction des chaînes utilisant une syntaxe personnalisée peut être moins précise.*

## Configuration [#config]

Ajoutez une entrée `json` dans `files`, avec un tableau `include` contenant des motifs glob. Utilisez l’espace réservé `[locale]` pour que le CLI puisse trouver les fichiers source et enregistrer les traductions au bon endroit.

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

Avec cette configuration, le CLI traduit chaque fichier JSON dans `i18n/en/`, enregistre les résultats dans `i18n/zh/`, `i18n/es/` et `i18n/ja/`, et ignore les fichiers dans `i18n/en/exclude/`. Consultez la [référence de configuration](/docs/cli/reference/config#files) pour voir toutes les clés de configuration des fichiers.

## Métadonnées par clé [#metadata]

Ajoutez des instructions de traduction par clé à l’aide d’un fichier compagnon `.metadata.json` qui reprend la structure de vos fichiers source. Utilisez-le pour ajouter du contexte, des limites de caractères ou du contexte de code source à des clés spécifiques, sans modifier la source.

```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
    }
  }
}
```

Consultez la [référence des métadonnées associées aux clés](/docs/cli/reference/keyed-metadata) pour connaître tous les champs pris en charge.