Table of Contents
Assistant de traduction
Présentation
L'assistant de traduction peut être ouvert sur les boîtes de dialogues par appui sur la touche de fonction F2. Il facilite la création et la modification des lexiques de traduction de l'application dans des fichiers .properties. Capsis gère le français (_fr) et l'anglais (_en).
Les dialogues concernés sont les dialogues Capsis, les dialogues des modules et ceux des extensions. Les dialogues techniques comme le FileChooser de java ne sont pas concernés.
Les fichiers .properties
peuvent être issus :
- du noyau (ex
capsis. capsis/Labels_fr.properties
et_en
) - des modules (ex
pp3/Pp3Labels_fr.properties
et_en
) - des extensions (ex
capsis/extension/intervener/DHAThinner_fr.properties
et_en
)
Utilisation
L'assistant de traduction est une table à 4 colonnes.
- La première contient le nom de la clé utilisé dans le code source Java de la boite de dialogue
- Les 2 suivantes contiennent respectivement les traductions en Français et en anglais.
- La dernière indique le nom du fichier dans lequel la clé est déclarée
La première colonne contient les clés utilisées dans le code Java de la boîte de dialogue. Les deux autres colonne montrent les traductions respectivements en français et en anglais de ces clés, telle que connues par le traducteur Capsis (classe capsis.util.Translator).
Chaque lexique correspond à deux fichiers de traductions français et anglais. Par exemple, le lexique alisier.AlsLabels correspond aux deux fichiers alisier/AlsLabels_fr.properties et alisier/AlsLabels_en.properties.
Une fois les modifications terminées, le bouton Enregistrer permet de modifier les fichiers .properties concernés et de les recharger dans le Traducteur Capsis. Les modifications seront visibles à la prochaine ouverture du dialogue. Choix des lexiques pour l'écriture des traductions
Recherche des clés
La liste des clés de la première colonne est obtenue en lisant le code source de la boîte de dialogue. On s'assure ainsi que cette liste est bien complète (note technique : recherche des clés utilisées dans des “Translator.swap”). Les traductions dans les deux autres colonnes sont obtenues en interrogeant le traducteur (Translator).
Les clés dont la traduction est seulement modifiée sont réécrites dans le lexique ou elles ont été lues (interrogation du traducteur).
Si une traduction n'est pas trouvée (dans aucun fichier .properties), la cellule correspondante est laissée vide et le traducteur ne peut pas donner le lexique de provenance de la clé. Pour déterminer le lexique des clés qui n'avaient pas de traduction on procède dans l'ordre comme suit :
- recherche d'une référence directe au lexique dans le code source (note technique : en cherchant l'instruction “Translator.addBundle”),
- dans l'hypothèse ou le dialogue fait partie d'un module Capsis, recherche de la carte d'identité (idCard) du module en suivant les conventions de nommage ad hoc et si trouvée, demande du nom de lexique (par idCard.getModelBundleBaseName ()),
- création d'un lexique à partir du nom de classe et dans le même répertoire (pour les extensions par exemple).
Note : Cette méthode de détection permet de traduire les clés une fois le code source Java écrit sans avoir à ouvrir les fichiers .properties à l'aide d'un éditeur de texte.
Clés dupliquées
Avant la sauvegarde des modifications; l'assistant verifie si une clé est déclarée dans plusieurs fichiers .properties
. Si c'est le cas, l'assistant demande si les doublons doivent être supprimés.
Utilisateur SVN
Quand un lexique est créé, il doit être ajouté et commité sur SVN. Attention à ne commiter que les changements concernant vos modules/extensions.