Vérifier la localisation React lors de la relecture du code
Utilisez l’extraction, les contrôles des catalogues, TypeScript et la compilation de l’application pour détecter différents défauts de localisation avant la fusion.
Une modification de message React passe par le code source, l’extraction, un catalogue cible et le chargeur de l’application avant de parvenir aux personnes qui le lisent. Examinez cette chaîne autant que la formulation. Une traduction correcte associée à une identité obsolète ne s’affiche jamais ; un repli sur le texte source peut masquer une traduction manquante tout en laissant l’écran utilisable.
Cette méthode s’applique au paquet React actuel, avec des catalogues JSONC extraits par la CLI. Complétez les contrôles d’extraction de la CLI par les vérifications de compilation et de rendu propres au projet.
Inspecter d’abord la modification du code source #
Lisez le nouveau message source comme une instruction ou une affirmation destinée à l’utilisateur. Lisez ensuite son contexte. « Bouton » décrit une forme ; « Annuler un paiement programmé avant son envoi » explique l’action dont le sens doit être préservé. Le texte source et le contexte contribuent tous deux à l’identité : une modification du seul contexte peut donc nécessiter une nouvelle entrée cible.
Lors de la relecture, considérez les espaces réservés comme des valeurs dont la fonction reste stable. La personne qui traduit doit pouvoir déplacer le nom d’une personne ou un montant sans en changer l’identité. Pour le texte enrichi, conservez la navigation et le comportement des composants dans le code, tout en traduisant la phrase autour des balises nommées. Messages et Texte enrichi détaillent les API exactes.
Vérifier l’extraction avant les catalogues cibles #
Depuis le répertoire du projet concerné, avec la CLI installée :
lingo extract --check
lingo checkUtilisez les mêmes options --src, --source-locale, --out et --types que la commande d’extraction du projet. La langue source est en par défaut ; la configuration de localisation ne change pas la valeur par défaut de cette commande. Exécutez ensuite la vérification TypeScript et la compilation de production du dépôt, en incluant les déclarations générées.
| Défaut à introduire dans un jeu de test local pour la relecture | Contrôle bloquant et résultat attendu |
|---|---|
| Modifier un message source sans régénérer les catalogues ni les déclarations. | extract --check compare les résultats générés et échoue lorsqu’ils sont obsolètes. |
| Omettre le contexte requis dans un message extrait. | check signale le problème d’extraction ou de contexte ; inspectez le code source pour rétablir le sens. |
| Laisser une entrée manquante ou vide dans un catalogue JSONC cible existant. | check signale la traduction manquante dans le catalogue détecté. |
| Laisser les déclarations générées obsolètes. | L’extraction et la vérification détectent l’écart dans les éléments générés ; TypeScript vérifie séparément leur utilisation dans l’application. |
| Faire échouer un import de langue ou une intégration au framework. | La compilation réelle de l’application devrait révéler l’échec de l’intégration. |
Utilisez un jeu de test local lorsque vous mettez ces contrôles en place pour la première fois. extract --check réussit même lorsqu’aucun fichier source n’est trouvé : assurez-vous donc que le répertoire indiqué contient bien le code attendu. Sinon, un résultat au vert peut signifier que le contrôle n’a rien inspecté.
Vérifier explicitement la couverture des langues requises #
Lorsque les motifs files dans .lingo/config.json correspondent au catalogue source (par exemple locales/en.jsonc), lingo check exige également un fichier pour chaque langue cible configurée. Le motif utilisé par lingo init --yes pour écrire les fichiers, locales/en.json, ne correspond pas à un catalogue .jsonc : seules les vérifications React sont donc exécutées avec ce motif. Le contrôle ne signale une clé manquante que dans les catalogues JSONC cibles existants. Lors de la relecture, comparez la liste des langues requises aux fichiers et aux imports. Supprimez temporairement une entrée cible dans un jeu de test local pour voir comment le repli sur le texte source se manifeste à l’écran.
Lisez des paires source/cible représentatives pour en vérifier le sens, en particulier les engagements modifiés et les termes du produit. Un contrôle de cohérence JSONC sans erreur n’évalue pas ce sens. Les fichiers ARB, les fichiers XML Android, les catalogues Apple et les documents statiques nécessitent leurs propres validations, plutôt que ce contrôle de couverture spécifique à React.
Résoudre les différences sans perdre les résultats déjà relus #
Régénérez les résultats obsolètes avec lingo extract, inspectez les entrées ajoutées et orphelines, puis traduisez les changements nécessaires. Préservez les formulations cibles déjà relues ainsi que le verrou de localisation. La suppression des entrées orphelines modifie les catalogues et doit faire l’objet d’une relecture distincte de celle de la modification du message source.
Choisissez si les traductions arrivent sur la branche source ou via une PR de traduction distincte. Le guide CI explique les compromis liés à la livraison et les différences propres à l’App gérée. Dans les deux cas, séparez l’autorisation de fusionner de l’autorisation d’exécuter et de l’acceptation du contenu.
Terminez en chargeant l’écran modifié dans une langue cible avec des valeurs représentatives. Suivez les liens du texte enrichi, inspectez le comportement de repli et comparez le message affiché à l’action prévue. La relecture est terminée lorsque le cheminement du message dans le programme et sa formulation ont tous deux été examinés.