--- title: "Traduire des fichiers YAML et TOML" description: "Traduisez des fichiers .yaml, .yml et .toml jusqu’à 4 MB dans une ou plusieurs langues. Les clés, la hiérarchie et l’ordre restent inchangés. Exemples d’instructions pour Rails, Hugo et les fichiers de configuration." canonical: "https://ai-glot.com/docs/fr/formats/yaml-and-toml" updated: "2026-10-12" --- # Traduire des fichiers YAML et TOML Les fichiers YAML (`.yaml`, `.yml`) et TOML (`.toml`) jusqu’à **4 MB** sont acceptés. Seules les valeurs de chaîne sont modifiées : les clés, les niveaux d’imbrication, les tables et l’ordre des clés sont conservés. Parmi les usages courants : les fichiers de langue Rails et Symfony, le contenu de sites statiques et les tables i18n de Hugo. > **Tip: Essayez gratuitement** > > Déposez un fichier de 2 MB maximum dans les traducteurs gratuits [YAML](https://ai-glot.com/file-formats/yaml-translation) ou [TOML](https://ai-glot.com/file-formats/toml-translation) pour les essayer sans compte, dans la limite de cinq fichiers par jour. L’application, l’API et la CLI acceptent les fichiers jusqu’à 4 MB. ## Éléments traduits et éléments laissés intacts | | Traduits | Laissés intacts | | ---- | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | | YAML | Les valeurs de chaîne, y compris le texte dans les blocs multilignes | Les clés, la hiérarchie, l’ordre des clés, les nombres et les booléens | | TOML | Les valeurs de chaîne, remplacées chacune sur sa propre ligne | Les tables, les clés, l’ordre, les commentaires, les nombres, les dates et les chemins | Les espaces réservés tels que `%{name}` (Rails), `{name}` et `%s` sont protégés et conservés dans le texte traduit. ## Exemples d’instructions **Un fichier de langue Rails** Une langue, avec les espaces réservés d’interpolation et toutes les clés conservées. Traduisez les valeurs en français. Conservez %\{name} et %\{count} sans les modifier, et ne changez aucune clé. **Compléter les sections de langue** Pour un fichier YAML qui contient déjà une section par langue : plusieurs langues en une seule tâche. Remplissez les sections fr et de vides à partir de la section en. **Front matter et contenu** Pour un site statique : traduire le texte et conserver les paramètres. Traduisez uniquement les champs title, description et body en italien. Laissez les slugs, les dates, les layouts et les URL inchangés. **Une table i18n Hugo** Pour TOML : conserve les clés utilisées par les modèles. Traduisez les chaînes en portugais. Conservez à l’identique toutes les clés et tous les noms de table. **Uniquement les clés modifiées** Pour YAML : renvoie uniquement les clés qui ont été modifiées. Traduisez les valeurs en français et renvoyez uniquement les clés que vous avez modifiées. **Texte destiné aux utilisateurs dans un fichier de configuration** Laisse les paramètres intacts. Traduisez uniquement les messages et les libellés destinés aux utilisateurs en allemand. Laissez les paramètres, les identifiants, les chemins et les nombres inchangés. ## Bon à savoir - **Plusieurs langues dans une même tâche.** TOML peut gérer plusieurs langues : le plan ajoute une clé sœur avec un suffixe de langue, comme `hello_fr`, à côté de chaque clé d’origine. YAML peut gérer plusieurs langues si le fichier contient déjà une section pour chacune (`en:`, `fr:`, `de:`). Un fichier Rails classique avec une seule racine `en:` ne peut être traité que dans une langue par importation. Une demande portant sur plusieurs langues risque d’échouer et le plan ne pourra pas être préparé. Traitez le fichier une fois par langue : votre [glossaire](/docs/platform/glossaries) est conservé. - **Filtre de sortie.** Disponible pour YAML (« uniquement les clés modifiées »). TOML renvoie le fichier entier. - **Les commentaires YAML ne sont pas conservés.** Le fichier est lu comme des données, puis réécrit en YAML normalisé : les commentaires sont supprimés et l’indentation ainsi que les guillemets sont uniformisés sur deux espaces. Conservez le fichier source commenté comme référence. Les ancres restent valides, mais leur nom peut changer. - **Les commentaires TOML sont généralement conservés**, car chaque chaîne est remplacée sur sa propre ligne. Si une valeur ne peut pas être remplacée ainsi, par exemple lorsqu’elle se trouve dans une table en ligne, le fichier est réécrit dans un format normalisé et ses commentaires sont supprimés. Le plan vous indique quand cela s’applique. - **Limite.** 4 MB. ## Pages associées - [JSON, ARB et JSON Lines](/docs/formats/json) et [Java, INI, Fluent et PHP](/docs/formats/java-ini-fluent-php) pour d’autres formats de configuration et de fichiers de langue. - [Markdown](/docs/formats/markdown) pour le contenu qui accompagne la configuration. - [Tous les formats de fichiers](/docs/formats)