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

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

---

La CLI traduit les fichiers YAML, quelle que soit la bibliothèque i18n que vous utilisez. Les extensions `.yaml` et `.yml` sont toutes deux prises en charge, et 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`. Les autres bibliothèques peuvent être moins précises pour traduire les chaînes avec une syntaxe personnalisée.*

## Configuration [#config]

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

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

Consultez la [référence de configuration](/docs/cli/reference/config#files) pour obtenir la liste complète des clés de fichier.

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

Ajoutez des instructions de traduction par clé à l’aide d’un fichier compagnon `.metadata.yaml` qui reflète la structure de vos fichiers source.

```yaml title="translations.metadata.yaml"
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 par clé](/docs/cli/reference/keyed-metadata) pour obtenir la liste complète des champs pris en charge.