# gt: General Translation CLI tool: JSON
URL: https://generaltranslation.com/fr/docs/cli/reference/formats/json-files.mdx
Docs index: https://generaltranslation.com/llms.txt
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 CLI lit `package.json` pour déterminer comment traiter les chaînes JSON. `next-intl` utilise les messages ICU, tout comme `i18next` lorsque `i18next-icu` est installé. Utilisé seul, `i18next` conserve sa propre syntaxe, comme l’interpolation `{{name}}`. Avec les autres bibliothèques, les chaînes sont traduites comme de simples chaînes de caractères ; la traduction d’une syntaxe personnalisée peut donc ê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.

## Ordre de sortie [#order]

La CLI ne trie pas les clés dans les fichiers JSON traduits. Les fichiers de traduction GTJSON configurés avec [`files.gt`](/docs/cli/reference/config#files) restent triés par clé afin de produire des diffs stables.

<Callout type="info">
  **Modifié dans la v2.26.0 :** les fichiers JSON traduits ne sont plus triés par ordre alphabétique. La sortie GTJSON, elle, reste triée.
</Callout>

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

## Sitemap

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