Traduire des fichiers YAML et TOML
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.
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.
É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
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é.
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.
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.
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.
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.
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 racineen: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 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 et Java, INI, Fluent et PHP pour d’autres formats de configuration et de fichiers de langue.
- Markdown pour le contenu qui accompagne la configuration.
- Tous les formats de fichiers