JSONC
Traduisez des catalogues commentés à l’aide d’indications contextuelles et découvrez quels commentaires sont conservés dans le fichier traduit.
JSONC permet de garder un message et son explication au même endroit. Le gestionnaire de fichiers jsonc utilise le commentaire qui précède une chaîne comme indication de traduction et traduit les valeurs textuelles imbriquées en suivant les mêmes chemins que JSON.
Conservez ces commentaires dans le catalogue source. Le fichier cible reconstruit utilise une indentation de deux espaces et se termine par un saut de ligne. Il conserve les marqueurs @orphan sur les mêmes entrées que dans la source et supprime tous les autres commentaires. Tout système qui dépend d’autres métadonnées doit donc disposer d’un autre moyen de les conserver.
Placez le contexte à côté de la valeur concernée #
Ce catalogue précise l’action que le libellé « Retour » invite à effectuer :
{
/* @context Button that returns to the previous checkout step */
"back": "Back",
"product": "Acme",
}Le commentaire s’applique à la valeur textuelle suivante, et non à tous les descendants de l’objet qui la contient. Si un nombre, un booléen ou une valeur null s’intercale, l’indication en attente est effacée. Placez le commentaire juste avant la chaîne qu’il décrit et protégez les identifiants fixes à l’aide des commandes de l’interface choisie.
Avec @context, l’indication correspond au reste de la ligne. Sans ce marqueur, le commentaire entier sert d’indication : tout commentaire non vide placé avant une chaîne est donc transmis au traducteur. Lorsque plusieurs commentaires précèdent une chaîne, la dernière indication non vide est retenue, même si un commentaire précédent contient @context. @orphan signale des métadonnées du catalogue ; la chaîne peut néanmoins être sélectionnée pour la traduction de fichiers.
Traduction de fichiers et catalogues React #
L’extraction des catalogues React produit des catalogues JSONC à structure plate, avec des métadonnées associées aux entrées. Le lecteur de ces catalogues reconnaît @context, @src et @orphan ; l’extraction utilise ces champs pour conserver les emplacements dans la source et signaler les messages qu’elle ne retrouve plus. Il s’agit d’un workflow de gestion des catalogues, distinct de la traduction d’un document JSONC quelconque.
Consultez Catalogues et types React pour gérer les messages extraits. Ne supprimez pas les métadonnées du catalogue source en supposant que la traduction de fichiers standard les régénérera dans le fichier de sortie.
Configurez la traduction de fichiers #
La CLI déduit jsonc de .jsonc ; la GitHub App accepte le type de fichier configuré. Sélectionnez les chemins source et cible dans Configuration de la CLI ou Configuration de GitHub.
Conservez les bonnes valeurs #
La comparaison incrémentale, les chemins verrouillés, préservés ou ignorés et l’injection de langue suivent les règles propres au gestionnaire de fichiers JSON. Verrouiller un chemin copie les données source ; le préserver conserve les données cible ; l’ignorer le supprime. Consultez JSON pour connaître les règles de priorité et les conséquences d’un périmètre partiel, plutôt que de traiter ces mécanismes comme des exclusions interchangeables.
Vérifiez les clés et les valeurs protégées dans le fichier reconstruit, puis chargez le fichier cible à l’aide du lecteur de catalogues de l’application. Pour les catalogues React, veillez à ce que les métadonnées source restent accessibles à l’extraction : le fichier cible traduit conserve @orphan, mais pas @context ni @src.
Le workflow de traduction vérifie les structures de variables de substitution et les structures ICU prises en charge, notamment les arguments modifiés ou manquants. Examinez les avertissements ou les échecs signalés, puis effectuez le rendu du modèle accepté avec les valeurs fournies par votre application. Complétez ces contrôles structurels par une relecture du sens et une vérification de l’exhaustivité.