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

## Sitemap

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