YAML à racine de langue
Traduisez les valeurs sous une racine de langue et renommez cette racine pour la langue cible.
Rails lit la langue dans la racine d'un fichier YAML. Un fichier nommé checkout.es.yml définit toujours des ressources en anglais si sa racine est en:. Le gestionnaire yaml-root-key traduit les messages sous cette racine et la remplace par la langue cible, tout en préservant la cohérence des chemins de recherche entre les langues.
L'enveloppe de langue et les chemins des messages #
Un catalogue source peut contenir à la fois des interpolations et des branches de pluriel :
en:
checkout:
greeting: Hello, %{name}
items:
one: One item
other: "%{count} items"Les chemins des messages sont checkout.greeting, checkout.items.one et checkout.items.other. Ils n'incluent pas en, ce qui permet à la source anglaise et à la cible espagnole de partager les mêmes identifiants de message. L'enveloppe cible devient es ; checkout, one et other restent des clés.
La syntaxe d'interpolation et les noms des catégories de pluriel font partie du contrat de l'application. La traduction des mots ne configure pas les règles de pluriel de Rails et n'ajoute pas toutes les catégories requises par la langue cible. Vérifiez le rendu des quantités et des variables concernées dans l'application avant d'accepter les ressources.
L'analyseur exige une seule paire clé-valeur à la racine, composée d'une clé scalaire et d'une structure de correspondance en dessous. Une langue vide est autorisée, mais un message scalaire ou une liste directement sous la racine sont rejetés. Scindez tout fichier YAML multilingue en fichiers par langue, ou utilisez YAML générique si vous souhaitez conserver toutes les racines inchangées. Ne choisissez pas ce gestionnaire pour une spécification OpenAPI.
Mises à jour et périmètre partiel #
Les chaînes de caractères imbriquées sont comparées selon leurs chemins sous l'enveloppe de langue. La source actuelle fournit la structure ; la source précédente et la cible existante permettent de conserver les valeurs inchangées. Les commentaires et les ancres passent par la sérialisation de l'arbre YAML, qui peut normaliser la mise en forme.
Même avec un périmètre limité à certaines clés ou à certains termes, les traductions inchangées peuvent être réutilisées si une source précédente est fournie. La commande --key de la CLI utilise sa référence enregistrée, et l'ajout de --force n'empêche pas cette réutilisation. Pour corriger une formulation précise, modifiez directement la cible. Pour régénérer le fichier après avoir modifié les consignes, enregistrez les cibles acceptées et utilisez --force sur l'ensemble du fichier avec le périmètre choisi, sans --key, puis examinez chaque message modifié.
Lorsque le périmètre est limité à certaines clés, les chaînes non résolues des structures de correspondance situées hors de ce périmètre peuvent être omises. Les éléments des séquences conservent les valeurs sources plutôt que de changer de position. Vérifiez l'exhaustivité séparément de la réussite de l'analyse, surtout lorsque vous créez une nouvelle langue à partir d'un périmètre restreint.
Configurer la langue et la destination #
Définissez explicitement format: "yaml-root-key" pour les sources .yml ou .yaml. L'extension ne permet pas d'identifier l'enveloppe de langue. Les pages Configuration de la CLI et GitHub présentent les motifs de fichiers et l'organisation des cibles.
La reconstruction nécessite une langue cible et échoue si celle-ci n'est pas définie. La commande localeFormat de la CLI modifie l'écriture du chemin, pas la langue inscrite dans le YAML. Vérifiez à la fois la destination et sa racine, puis chargez un message de salutation et un message au pluriel via Rails. La page Localiser une application Rails explique comment relier ces fichiers à la sélection de la langue des requêtes, aux fonctions auxiliaires et au comportement de repli.