Format Ruby yaml
Ruby on Rails utilise YAML comme format de localisation par défaut avec une convention de structure de fichiers spécifique. Chaque fichier de locale est nommé d'après le code de locale — en.yml, fr.yml, de.yml — et la clé de niveau supérieur dans le fichier est le code de locale lui-même encadrant l'arborescence de clés entière. Le module I18n de Rails résout automatiquement le fichier correct en fonction de la locale actuelle.
Les fichiers YAML Rails commencent par le code de locale comme clé racine, suivi de hiérarchies de clés imbriquées qui reflètent la structure de l'application. Les modèles, contrôleurs et vues ont généralement chacun leur propre section. L'interpolation utilise des noms de variables encadrés de signes pourcentage. La pluralisation utilise les clés one et other par défaut, avec zero, few, many ajoutés pour les langues qui les nécessitent. Les noms de modèles ActiveRecord et les libellés d'attributs pour les messages d'erreur suivent une convention spécifique sous la clé activerecord.
Bonne pratique : suivez les conventions d'espace de noms de Rails — utilisez le modèle controller.action.key pour les chaînes de vue et le modèle activerecord.models.name pour le contenu lié aux modèles. Exécutez le gem i18n-tasks en CI pour détecter les traductions manquantes, les clés inutilisées et les incohérences entre les fichiers de locale. Utilisez la recherche différée dans les vues — les appels i18n peuvent résoudre la clé de locale automatiquement en fonction du chemin du fichier de vue. Language Monster prend en charge le format YAML Ruby et préserve la hiérarchie de clés de locale Rails lors de la traduction.