Installation et configuration

• Installer le module JTranslate
• Installer le provider ou les providers à supporter (vous référer aux fiches des fournisseurs précisées dans la page de présentation du module).
• Configurer les services de traduction comme décrit dans la section dédiée ci-dessous.
• Définir un groupe d'utilisateurs et les droits via l'ACL (voir Gestion des contrôles d'accès)
• Redémarrer le serveur d'application (ex. Tomcat)
• (Optionnel) Si le module DB commentaires est installé et prêt à l'emploi, veillez ce que les types de contenus à traduire soient commentables (les types doivent être activés et configurés).

Configuration des services de traduction

- Aller à la page de configuration du module dans l'espace administration.

Les propriétés suivantes peuvent être définies :

Types autorisant la traduction - Liste des types de contenus pouvant être traduits, si présent. Si le champ est vide, tous les types seront traduits.
Exemple : BlogPost Article WikiPage

Langues acceptées pour la détection - Code des langues habituellement en usage sur la plateforme et ouvertes à la traduction. Si le champ est vide, toutes les langues sont détectées sur les contenus. 
Exemple : fr en

Préférence des API - Liste ordonnée des API à utiliser pour la traduction des contenus
Exemple : Microsoft Google DeepL Systran Watson LinguaMachina

Clé API DeepL Translator - Clé à utiliser pour la connexion à ce service
Clé API Google Translate - Clé à utiliser pour la connexion à ce service
Clé API Microsoft Translator - Clé à utiliser pour la connexion à ce service
Clé API Systran Translation - Clé à utiliser pour la connexion à ce service

Identifiants IBM Watson - Identifiants à utiliser pour la connexion à ce service au format JSon.
Exemple :
{ "username": "___", "password": "___" }

Identifiants Lingua Machina - Configuration à utiliser pour la connexion à ce service au format JSon.
Exemple :
{ "username": "___", "password": "___", "project":"___", "url": "http://___.libellex.fr:7788", "languages": ["fr-en", "fr-es", ...] }

Fonctionnalités

Cliquer sur le menu des applications, puis l'application Traduction.

La page charge l'application de traduction, présentée ci-dessous.

Traduire via l'application

La traduction au sein de l'application s'effectue en fonction des paramètres suivants :

• Langue d'origine (Facultatif) - Si non précisé, la langue du texte sera détectée automatiquement.
• Langue de destination (Obligatoire) - La langue ciblée pour la traduction.
• Service de traduction (Facultatif) - Si non précisé, le traducteur le plus approprié en fonction de l'ordre des priorités des services, et du contexte, sera automatiquement choisi.
• Texte à traduire (Obligatoire) - Saisir librement le texte à traduire via le champ WYSIWYG.
• Texte traduit (non éditable) - Le résultat peut être copié collé dans une autre application.

La traduction s'opère automatiquement une fois que la saisie du texte à traduire est terminée ou lors du changement des paramètres.

Traduire un commentaire

Sur une page contenant des commentaires, vous avez la possibilité de traduire à la volée le contenu rédigé dans une langue que vous ne comprenez pas, comme illustré ci-dessous.

Traduire un flux d'activités

La traduction de contenus placés au sein de certaines portlets, par exemple dans la portlet Activités des membres peut s'avèrer pratique pour faciliter la conversation au quotidien.

Traduire un microblogging

Traduire une page Web

Traduire un article

Traduire une conversation

Intégration WYSIWYG

Les contenus de type WYSIWYG sont présents un peu partout sur la plateforme et intègre le module JTranslate.

Ceci permet donc de traduire des contenus à la volée dans n'importe quel champ WYSIWYG, comme illustré ci-dessous.

Aide à la rédaction de contenus

Cache et protection des contenus

Le module fonctionne à base d'un système de cache local permettant de réduire le nombre de requêtes distantes nécessaires pour traduire tous les contenus utilisateurs. Lorsqu'un utilisateur demande la traduction d'un contenu, le résultat est puisé à partir du cache lorsque possible. Les contenus internes sont protégés et non transmis aux services pour traduction, limitant également la taille des requêtes. 

Gestion des contrôles d'accès

L'interface d'administration permet la saisie des clés des services de traductions à utiliser. En plus de cela, le module fournit également des ressources d'ACL pour mieux gérer l'accès à certaines fonctionnalités par exempler autoriser la traduction des flux d'activités, la traduction des commentaires ou des contenus.

Extensibilité

JTranslate offre des points d'extensions présentés dans la documentation technique sur Jalios Doc.