# gt: General Translation CLI tool: YAML
URL: https://generaltranslation.com/fr/docs/cli/reference/formats/yaml-files.mdx
Docs index: https://generaltranslation.com/llms.txt
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.

## Sitemap

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