YAML
Traduisez les chaînes imbriquées dans YAML sans modifier les clés du catalogue, et choisissez un autre gestionnaire lorsque la racine ou le schéma a une signification particulière.
Le gestionnaire de fichiers yaml traduit les chaînes dans les structures associatives et les séquences imbriquées. Il conserve les clés que le code de l’application utilise pour rechercher les valeurs, ainsi que les nombres et les booléens. Utilisez-le pour un catalogue dont la structure reste identique d’une langue à l’autre.
Déterminer si le gestionnaire YAML générique convient #
Par exemple, ce catalogue regroupe les messages de paiement sans les placer sous une clé de langue :
checkout:
title: Complete your order
steps:
- Review your items
- Confirm delivery
retries: 3Le gestionnaire sélectionne checkout.title et les deux chaînes de la séquence. retries reste une valeur numérique. Un identifiant entre guillemets serait également sélectionné, puisqu’il s’agit d’une chaîne. Gardez cette distinction à l’esprit lorsque vous choisissez les données à inclure dans le catalogue.
Utilisez YAML avec langue à la racine pour une clé racine en: de type Rails qui doit être remplacée par la langue cible. Le gestionnaire YAML générique conserve en:, même lorsque le nom du fichier devient es.yml. Rails peut alors ignorer le contenu, car sa racine indique toujours l’anglais.
Utilisez OpenAPI pour une spécification d’API. Le gestionnaire YAML générique sélectionnerait aussi les identifiants d’opérations, les références et les exemples dont les valeurs sont des chaînes. Une extension .yml ne permet pas de distinguer ces usages.
Réutilisation et reconstruction #
La source actuelle définit l’arborescence de sortie. Une source précédente permet de déterminer si la chaîne à chaque chemin a changé, et la cible existante fournit les valeurs aux chemins correspondants. De nouvelles traductions remplacent les chaînes modifiées ; les chaînes inchangées peuvent conserver leurs traductions existantes, même lorsqu’elles sont sélectionnées dans un périmètre défini par clé ou par terme.
La CLI fournit sa version de référence enregistrée pour --key ; cette sélection ne permet donc pas de régénérer de façon fiable les formulations YAML inchangées. Ajouter --force à la même commande n’y change rien. Modifiez directement la cible pour apporter une correction précise, ou enregistrez les cibles acceptées et utilisez --force sur l’ensemble du fichier dans un périmètre défini, sans --key, pour régénérer les traductions. Relisez tout le fichier après son remplacement.
La reconstruction utilise un arbre syntaxique YAML pour conserver les commentaires et la structure des ancres tout en remplaçant les valeurs. La sérialisation peut normaliser la mise en forme. Les commentaires restent des éléments du document, et non des instructions de traduction. Vérifiez les alias avec l’outil qui lit votre YAML, en particulier lorsqu’une même valeur apparaît par l’intermédiaire de plusieurs références.
Une exécution limitée à certaines clés peut supprimer une chaîne non résolue d’une structure associative hors du périmètre lorsqu’aucune valeur cible n’existe. Les chaînes des séquences conservent leur valeur source pour éviter de décaler les positions. Un périmètre partiel ne garantit donc pas que toutes les chaînes du fichier sont traduites.
Configurer et charger le catalogue #
Définissez explicitement format: "yaml" pour les sources .yaml ou .yml dans la configuration de la CLI. La détection lors du push exclut les fichiers YAML dont le format n’est pas explicitement défini. La GitHub App dispose de sa propre sélection de dépôts.
Adaptez le chemin cible au mécanisme de chargement de l’application. Une source telle que config/locales/checkout.en.yml et une source située à locales/en/checkout.yml nécessitent des méthodes différentes pour déterminer ce chemin. Les positions dans les séquences identifient aussi les messages : déplacer un élément peut changer la traduction existante qui lui correspond. Vérifiez le catalogue chargé après toute modification de structure. Pour la recherche dans Rails, la sélection de la langue et le mécanisme de repli, consultez Localiser une application Rails et utilisez le gestionnaire avec langue à la racine.