Format yaml général
YAML est largement utilisé pour la localisation dans Ruby on Rails, les projets Symfony PHP et les applications Vue.js. Sa syntaxe clé-valeur indentée est plus lisible que JSON pour les structures imbriquées complexes et prend en charge nativement les chaînes multilignes et les commentaires — utile pour documenter le contexte du traducteur directement dans le fichier.
Les fichiers de locale YAML utilisent des hiérarchies de clés indentées où chaque niveau d'indentation crée un espace de noms imbriqué. Le niveau supérieur est généralement le code de locale encadrant l'arborescence des clés — la convention standard pour les fichiers de locale Ruby on Rails. Les valeurs de chaînes peuvent être écrites en ligne ou comme des scalaires en bloc pour le texte multiligne. La syntaxe d'interpolation varie selon le framework : Rails utilise des noms de variables encadrés de signes pourcentage, Symfony utilise la syntaxe à doubles accolades.
Bonne pratique : évitez les caractères YAML spéciaux dans les valeurs de chaînes — les deux-points, les dièses, les crochets et les accolades doivent être entre guillemets pour éviter les erreurs d'analyse YAML. Utilisez la notation scalaire en bloc pour les chaînes longues afin de maintenir la lisibilité. Gardez les fichiers de locale structurés de manière cohérente entre les langues pour faciliter la détection des traductions manquantes. Language Monster prend en charge le format YAML général et préserve la structure des clés imbriquées lors de la traduction.