Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.
Remarque

Ce document représente une exploitation de la documentation de référence citée. Cette documentation “générale” doit être privilégiée.

Sommaire
minLevel1
maxLevel6
outlinefalse
typelist
printablefalse

Paramétrage

L'ordre des dictionnaires, ainsi que les formatages de date, de caractère séparateur de milliers et décimal, sont réglés dans le fichier translateParams.txt.

Bloc de code
<LanguageCode>CA<Description>Francais Canadien<DATEType>BE<HELPCODE>FR<DateSeparator>-
<LanguageCode>EN<Description>Anglais<DATEType>BE<HELPCODE>EN<DateSeparator>-<ThousandSeparator>Comma<DecimalSeparator>Point

<Dictionnary>Divalto<Language>EN
  <file>client_en.dhot
  <file>dan_en.dhot
  <file>infinitylangue_en.dhot
  <file>infinitylangue_imp_en.dhot

<LanguageBaseData>CA
<LanguageCodeData>CA,EN
Info

L’ordre de prise en compte des dictionnaires d’une langue est similaire aux implicites : la première traduction trouvée est renvoyée.

Complément : https://divalto.atlassian.net/wiki/spaces/PAI/pages/10558210447/Traduction+des+applications#Mise-en-place-des-dictionnaires-compil%C3%A9s

Génération d'un dictionnaire

Généralités

La mise en œuvre d'un dictionnaire de traduction nécessite plusieurs outils : Xwin et Xtranslate, et possiblement Excel pour définir les traductions en masse.

...

  1. Xwin permet d'extraire les libellés pour générer le dictionnaire de référence (exemple : dictio.dhfi/dhfd)

  2. Xtranslate permet de créer et gérer les dictionnaires de traduction par langue (exemple : dictio_EN.dhfi/dhfd) à partir du dictionnaire de référence

  3. Xtranslate permet de compiler les dictionnaires objet (dictio_EN.dhot) qui sont les seuls requis à l'exécution

Source : https://divalto.atlassian.net/wiki/spaces/PAI/pages/10558210447/Traduction+des+applications#Cr%C3%A9ation-des-dictionnaires

Extraction

Préparation dossier

  • Créer un dossier accessible par les implicites de l'environnement

  • Placer dans ce dossier les sources spécifiques dhsf, dhsi, dhsp. Ne pas copier les dhsd ni les masques "_base".

  • Les sources dhsq peuvent être incluses (utiles si développement par des non francophones)

  • Ajouter les fichiers menus surchargés spécifiques (a5fu, ccfu, g3fu, gafu, r3fu, etc).

  • Ajouter les fichiers d'erreur spécifiques.

  • Il n'est pas nécessaire d'ajouter les dictionnaires multichoix, les éléments utilisés sont inclus dans les sources de masques.

Préparation fichier complémentaire

Pour extraire le contenu des menus et des fichiers d'erreur, il est nécessaire de fournir à Xwin un fichier complémentaire .txt. Exemple et recommandation de contenu :

Bloc de code
<Fichier_dico>a5fu.dhfi<enreg>m4<Champ>lib
<Fichier_dico>c3fu.dhfi<enreg>m2<Champ>lib<Champ>titre2
<Fichier_dico>g3fu.dhfi<enreg>m2<Champ>lib<Champ>titre2
<Fichier_dico>gafu.dhfi<enreg>m2<Champ>lib
<Fichier_dico>r3fu.dhfi<enreg>m2<Champ>lib

<Fichier_dico>miferr.dhfi<enreg>Xerr<Champ>errtxt

<FiltreIgnorer><like>#*

Enregistrer ce fichier dans le dossier d'extraction.

Info

Un fichier de paramètres complémentaires est fourni avec les dictionnaires de traductions standard : paramtrad.txt

Extraction des libellés

  • Lancer Xwin

  • Lancer le menu Outils/Traduction/Extraire les libellés en vue de la traduction

...

  • Répertoire source est le chemin vers le dossier préparé au chapitre précédent.

  • Code langue de référence est 'FR', Code page est '0'

  • Dictionnaire de référence est le nom du dictionnaire de référence qui sera créé / mis à jour. Ne pas oublier l'extension .dhfi !

Info

Note : l'option "Effacer complètement le fichier" cassera le lien avec les dictionnaires de traduction qui ne pourront plus être mis à jour à partir de ce dictionnaire de référence. Il faudra générer un nouveau dictionnaire de traduction, puis importer les traductions de l'ancien dictionnaire de traduction.

  • Fichier de paramètres complémentaire est le fichier préparé au chapitre précédent pour forcer l'import des données de menus

  • Cocher la case "Extraire uniquement les nouveaux libellés" : Permet d'ignorer les libellés déjà présents dans un autre dictionnaire

  • Renseigner le nom du dictionnaire de référence DAN

  • Lancer l'extraction

Source : https://divalto.atlassian.net/wiki/spaces/PAI/pages/10558210447/Traduction+des+applications#Cr%C3%A9ation-d%27un-dictionnaire-de-r%C3%A9f%C3%A9rence

Travail du dictionnaire de traduction

Création / Mise à jour

  • Lancer Harmony puis Xtranslate (Menu Éditeurs/Traduction)

  • Lancer le menu Générer / mettre à jour le dictionnaire de traduction à partir du dico de référence

  • Renseigner le nom du dictionnaire de référence, le nom du dictionnaire de traduction et le code langue associé

...

  • Lancer le traitement

Source : https://divalto.atlassian.net/wiki/spaces/PAI/pages/10558210447/Traduction+des+applications#Cr%C3%A9ation-d%27un-dictionnaire-en-langue-%C3%A9trang%C3%A8re

Insertion des traductions

  • Depuis Xtranslate, lancer le menu 'Exporter vers fichier tableur'

...

  • Choisir l'option 'Texte original – étranger' pour obtenir un fichier listant les traductions nouvelles / existantes. L'option 'pour réintégration' n'exporte que les termes déjà traduits, avec une numérotation "dans l'ordre des traductions insérées" qui ne précise pas le contexte.

  • L'option préfixe (gt, rc, cc, sans ‘*', séparés par ‘;') permet d'obtenir des fichiers excel par "contexte" de module, permettant une traduction plus fine. Il conviendra de faire autant d’extractions que de préfixes existants dans le dossier des sources spécifiques, en plus d’une extraction sans préfixe (complète).

Remarque

Attention : un fichier Excel existant sera écrasé par l'extraction, il n'est pas possible d'obtenir directement des onglets par module.

  • Chaque fichier excel peut être agrémenté ainsi :

    • Les cellules A1 et A2 doivent contenir les infos préfixe.

    • La ligne 2 peut contenir les entêtes pour filtrage

    • Les cellules de la colonne A peuvent pointer sur le préfixe

...

  • Construire un fichier tableur regroupant l'ensemble des termes à traduire avec leur contexte, en complétant si nécessaire avec les termes sans contexte.

  • Ajouter les traductions dans le fichier tableur global. Si la traduction est identique au terme FR (cas fréquent avec FR -> CA), laisser vide (permet de bénéficier des évolutions des termes FR)

Info

Les termes du dictionnaire de traduction sont sensibles à la casse, contrairement aux fonctions de recherche standard d’Excel. Veillez à ne pas supprimer des ‘faux doublons’.

  • Reporter les traductions dans chaque fichier d'export individuel pour permettre l'import par contexte

  • Importer les traductions avec le menu dédié, et selon les caractéristiques du tableau (ligne d'entête, etc)

...

  • Le bouton ‘Charger les préfixes depuis le fichier du Tableau’ s’active quand on se place sur le champ préfixe. En cliquant sur ce bouton, la cellule B1 du fichier tableur sera lue et les préfixes définis.

Remarque

Importer un fichier sans préciser les préfixes placera les traductions contenues partout où c’est possible, introduisant des possibles incohérences.

Exemple, ‘Dépôt’ devrait être traduit par ‘Warehouse’ dans les modules ‘gt;g3', et par ‘Deposit’ dans les modules 'cc;rc;c3;r3’

  • Le choix de modifier les lignes du dictionnaire de traduction au statut ‘Terminé’ peut avoir des conséquences inattendues, il est recommandé de modifier le statut des lignes dont on est pas certain de la traduction par ‘À réviser’ avant l’import.

Info

Il est recommandé d’importer les traductions par contexte connu, ce qui modifiera le statut des lignes à ‘Terminé’, avant d’importer un fichier contenant des traductions sans contexte. Ce qui, avec des options standard, n’entrainera pas l'écrasement des traductions introduites par contexte.

...

  • À l’issue des imports, ouvrir le dictionnaire de traduction

  • Cliquer sur 'Charger toutes les lignes', puis sur 'traduction' pour voir les traductions dans leurs contextes

  • Le bouton 'Synchroniser' permet d'afficher le contexte du masque dans Xwin pour chaque ligne

...

  • Vérifier, compléter, modifier les traductions.

Source : https://divalto.atlassian.net/wiki/spaces/PAI/pages/10558210447/Traduction+des+applications#Le-programme-xTranslate

Exploitation de traductions existantes

Un terme peut avoir été traduit dans un dictionnaire plus "général", dans un contexte différent. Exemple : un libellé copié d'un masque vers un autre qui change d’ID.

Il est possible d'utiliser ces traductions dans son propre dictionnaire. Il faut disposer pour cela :

  •  Du dictionnaire de référence général (exemple infinitylangue.dhfi)
  •  Du dictionnaire de traduction compilé (exemple infinitylangue_EN.dhot)

 

  • Depuis Xtranslate, lancer le menu Outils/Utiliser les traductions d'autres dictionnaires objets

  • Saisir les chemins des dictionnaires dans lesquels prendre les traductions.

...

Remarque

À l’heure actuelle, utiliser un dictionnaire objet qui contient lui même des liens vers un autre dictionnaire objet (tel que dan_en) provoque une remontée de traduction erronée.

  • Lancer le traitement. Un terme peut avoir été traduit de plusieurs façons en fonction du contexte. Dans ce cas le programme propose de choisir le terme approprié pour résoudre les ambiguïtés

...

  • Si un terme n’est pas arbitré, aucun lien n’est établi avec le dictionnaire objet. Le terme reste à traduire.

  • Les termes ayant un lien avec un dictionnaire objet sont identifiables dans Xtranslate

...

Info

Il n'est pas possible de revenir au traitement des ambigüités une fois sorti de la fenêtre. Il faut relancer le programme de "captation" des dictionnaires objets.

Si une traduction est modifiée dans un dictionnaire objet, et si l'arbitrage éventuel a été fait, la nouvelle traduction est automatiquement disponible dans les programmes, sans avoir besoin de mettre à jour le dictionnaire "final". Cependant, en éditant ce dictionnaire "final", la traduction associée au lien vers le dictionnaire objet n'aura pas été mise à jour. Pour éviter les quiproquos, il est recommandé de refaire une nouvelle "captation" des traductions générales.

Source : https://divalto.atlassian.net/wiki/spaces/PAI/pages/10558210447/Traduction+des+applications#Utiliser-des-traductions-d%27autres-dictionnaires-objets

Remplacement de traductions existantes

Un terme traduit dans un dictionnaire général peut ne pas convenir et on peut vouloir remplacer cette traduction.

  • Depuis Xtranslate lancer le menu options/Importer les textes d'un autre dictionnaire dans un dictionnaire de référence

  • Saisir le texte original à importer

...

  • Propager les ajouts du dictionnaire de référence au dictionnaire de traduction (chapitre précédent)

  • Ajouter les traductions souhaitées

Info

Si des traductions ne sont pas renseignées, les traductions des autres dictionnaires resteront utilisées

Source : https://divalto.atlassian.net/wiki/spaces/PAI/pages/10558210447/Traduction+des+applications#Importer-les-textes-d%27un-autre-dictionnaire-dans-un-dictionnaire-de-r%C3%A9f%C3%A9rence

Compilation

  • Depuis Xtranslate, cliquer sur le bouton Compiler (ou touche F11)

  • Valider

Source : https://divalto.atlassian.net/wiki/spaces/PAI/pages/10558210447/Traduction+des+applications#Compilation-du-dictionnaire

Utilisation du dictionnaire de traduction

Dans Xwin

Pour vérifier l'application des traductions, et que les dimensions permettent l'affichage complet d'une traduction, Choisir la langue d'affichage dans Xwin

...

À l'exécution

Définir la langue d'affichage de l'interface :

  • Pour le lancement du client léger

    • Cliquer sur 'Options' depuis la fenêtre de connexion

    • Définir la langue pour 'Code langue écran'

  • Pour le client web

    • Cliquer sur le menu "brochette" puis sur 'Gestion des profils utilisateurs

    image-20240111-142456.pngImage Added
    • Choisir le profil / environnement à modifier

    • Définir la langue pour 'Code langue écran'

...