Traduction IA pour les fichiers de propriétés Java

Préparer les fichiers de propriétés pour des traductions de haute qualité

Maintenant que vous savez comment traduire les fichiers .properties avec PTC, gardez à l’esprit que la qualité de vos fichiers source affecte directement la qualité de vos traductions. Ces bonnes pratiques pour les fichiers Java .properties empêchent les traductions incorrectes, les erreurs d’exécution et les expériences utilisateur déroutantes.

Utiliser des clés claires et descriptives

button.submit=Envoyer
error.unauthorized=Vous n'êtes pas autorisé à accéder à cette page.

button.submit=Submit
error.unauthorized=You are not authorized to access this page.

btn1=Envoyer
msg2=Non autorisé

btn1=Submit
msg2=Unauthorized

L’utilisation de clés descriptives permet de savoir facilement à quoi sert chaque chaîne. Si vous n’utilisez que des codes courts comme btn1 ou msg2, il devient presque impossible de savoir quel texte appartient à quelle partie de votre application, surtout lorsque vous ajoutez d’autres chaînes ou que vous intégrez de nouveaux développeurs au projet.

Conserver tous les textes destinés à l’utilisateur dans les fichiers .properties

button.submit=Envoyer

button.submit=Submit

button.setText(bundle.getString("button.submit"));

button.setText(bundle.getString("button.submit"));

button.setText("Envoyer");

button.setText("Submit");

Les chaînes codées en dur ne seront pas traduites par PTC. Votre application affichera un mélange de textes traduits et non traduits, ce qui semblera peu professionnel et déroutant pour les utilisateurs.

Utiliser des placeholders pour le contenu dynamique

greeting=Bonjour, {0} ! Vous avez {1} nouveaux messages.

greeting=Hello, {0}! You have {1} new messages.

String message = MessageFormat.format(
 bundle.getString("greeting"), user, count);

String message = MessageFormat.format(
    bundle.getString("greeting"), user, count);

System.out.println("Bonjour, " + user + " ! Vous avez " + count + " nouveaux messages.");

System.out.println("Hello, " + user + "! You have " + count + " new messages.");

La concaténation de fragments empêche PTC de comprendre la phrase entière. De nombreuses langues modifient l’ordre des mots, les formes plurielles et les règles d’accord. Une phrase comme « Bonjour, Maria ! Vous avez 3 nouveaux messages. » ne peut pas être exprimée correctement si elle est divisée en morceaux.

En utilisant des placeholders, PTC traduit naturellement la phrase entière, et Java insère les bonnes valeurs lors de l’exécution.

Échapper correctement les caractères spéciaux

Certains caractères sont réservés dans les fichiers .properties car ils affectent la façon dont Java analyse le fichier :

• = ou : → sépare les clés des valeurs
• # ou ! → démarre un commentaire
• \ → introduit des séquences d’échappement (comme \n pour un saut de ligne)

Si vous voulez que ces caractères apparaissent dans le texte, échappez-les avec une barre oblique inverse.

message=Enregistrer avec la clé\: Ctrl+S

message=Save using key\: Ctrl+S

message=Enregistrer avec la clé : Ctrl+S

message=Save using key: Ctrl+S

Si les caractères spéciaux ne sont pas échappés, Java divise la chaîne de manière incorrecte et PTC ne voit qu’une partie du texte. Cela signifie que vos traductions reviendront incomplètes, et lors de l’exécution, vos utilisateurs pourront voir des messages manquants ou incorrects.

Enregistrer les fichiers en UTF-8

Enregistrez toujours les fichiers .properties en UTF-8. Sans UTF-8, les caractères non-ASCII sont corrompus (par exemple, é se transforme en é). Cela rend les traductions illisibles et force des corrections manuelles de réencodage.