Outils de Développement Essentiels pour l'Internationalisation : Différenciateur JSON et Éditeur de Messages ICU

La localisation (i18n) ne consiste pas seulement à traduire des mots, mais à gérer des structures de fichiers complexes, à traiter du contenu dynamique et à garantir la qualité dans toutes les langues. En tant que développeurs, nous sommes souvent confrontés à deux problèmes spécifiques :

1. Gérer d'énormes fichiers de traduction JSON : Repérer ce qui a changé entre deux versions d'un fichier JSON de 5 000 lignes est un cauchemar avec les outils de différenciation standard.
2. Écrire des messages ICU complexes : Les erreurs de syntaxe dans les pluriels ou les déclarations select font souvent planter les applications lors de l'exécution.

Chez IntlPull, nous avons été confrontés à ces mêmes défis. C'est pourquoi nous avons créé deux outils puissants pour les résoudre, et nous les mettons gratuitement à la disposition de la communauté.

1. Différenciateur Visuel de Traduction JSON

Les outils de différenciation standard comme git diff ou les comparateurs de texte sont basés sur les lignes. Ils ne comprennent pas la structure du JSON. Si vous réorganisez les clés ou modifiez l'indentation, les outils standard affichent l'ensemble du fichier comme modifié.

Notre Différenciateur de Traduction JSON est sémantiquement conscient. Il comprend que le JSON est un objet, et non pas seulement des lignes de texte.

Caractéristiques Clés

• Comparaison Consciente de la Structure : Ignore les changements d'ordre des clés et les différences de formatage. Il ne met en évidence que les changements de contenu réels.
• Support des Clés Imbriquées : Aplatit et compare automatiquement les objets imbriqués (par exemple, auth.login.title) afin que vous puissiez voir exactement quel nœud feuille a changé.
• "Afficher/Masquer les Inchangés" : Basculez pour vous concentrer exclusivement sur ce qui est nouveau, supprimé ou modifié.
• Codage Couleur Visuel :
  • <span style="color: #4ade80">Vert</span> pour les clés ajoutées.
  • <span style="color: #f87171">Rouge</span> pour les clés supprimées.
  • <span style="color: #facc15">Jaune</span> pour les valeurs modifiées.
• Rapports Exportables : Générez un rapport JSON des différences à partager avec votre équipe de localisation ou à joindre à une Pull Request.

Cas d'Utilisation : Révision des Mises à Jour de Traduction

Imaginez que votre agence de traduction renvoie un nouveau fr.json. Avant de le fusionner dans votre base de code, vous voulez vous assurer qu'ils n'ont pas accidentellement supprimé des clés ou modifié des clés qui n'auraient pas dû être touchées.

En utilisant le Différenciateur JSON :

1. Collez votre fr.json original à gauche.
2. Collez le nouveau fichier à droite.
3. Voyez instantanément que 5 clés ont été ajoutées, 0 supprimée, et 12 modifiées.
4. Vérifiez qu'aucune clé critique ne manque avant de fusionner.

2. Éditeur et Validateur de Messages ICU

Le Format de Message ICU est la norme de l'industrie pour gérer les pluriels, la sélection de genre et la substitution de variables. Cependant, la syntaxe est notoirement difficile à écrire et facile à casser.

Une accolade fermante manquante } ou une faute de frappe dans un mot-clé peut faire planter toute votre application React ou Next.js lors de l'exécution.

Notre Éditeur de Messages ICU fournit un bac à sable sécurisé pour écrire, tester et valider vos messages.

Caractéristiques Clés

• Aperçu en Temps Réel : Tapez votre message et voyez instantanément comment il s'affiche.
• Terrain de Jeu de Variables : L'outil détecte automatiquement les variables (par exemple, {name}, {count}) et génère des champs de saisie pour que vous puissiez tester différentes valeurs.
• Validation de Syntaxe : Obtenez un retour immédiat si vos accolades sont déséquilibrées ou si votre syntaxe est invalide.
• Modèles Prédéfinis : Confus sur la façon d'écrire un pluriel ? Modèles en un clic pour :
  • Pluriels : {count, plural, =0 {Aucun élément} other {# éléments}}
  • Select : {gender, select, male {Il} female {Elle} other {Ils}}
  • Date/Heure/Nombre : Modèles de formatage standard.

Cas d'Utilisation : Pluriels Profondément Imbriqués

Écrire une phrase comme "Vous avez 3 messages dans 2 dossiers" où les deux nombres sont dynamiques est complexe.

Approche standard : Deviner la syntaxe, exécuter l'application, la voir planter, réessayer.

Avec l'Éditeur ICU :

1. Ouvrez l'Éditeur ICU.
2. Utilisez le modèle "Variables Multiples".
3. Tapez : Vous avez {msgCount, plural, =1 {# message} other {# messages}} dans {folderCount, plural, =1 {# dossier} other {# dossiers}}.
4. Testez avec msgCount=1, folderCount=5 -> "Vous avez 1 message dans 5 dossiers."
5. Testez avec msgCount=2, folderCount=1 -> "Vous avez 2 messages dans 1 dossier."
6. Copiez la chaîne validée dans votre code.

Pourquoi Nous Avons Construit Cela

Nous avons construit ces outils parce que nous en avions besoin pour IntlPull, notre plateforme de gestion de localisation. En construisant un système pour automatiser les traductions, nous avons réalisé que les tâches "simples" de vérification des différences et d'écriture de syntaxe étaient encore manuelles et sujettes aux erreurs.

Ces outils sont des parties gratuites de notre mission d'améliorer l'expérience des développeurs pour l'internationalisation.

Prêt à Optimiser Votre Flux de Travail ?

• Commencez à comparer les fichiers avec le Différenciateur JSON.
• Testez vos chaînes avec l'Éditeur de Messages ICU.
• Pour une solution complète, consultez IntlPull pour automatiser tout votre flux de travail de traduction.