Cette page explique succinctement les fonctions de base du plugin de traduction automatique via l’API Deepl. Vous obtiendrez plus de détail sur la page : https://crossmedia.atlassian.net/wiki/spaces/WD/pages/2827485192/Setting+up+the+Deepl+Bridge+Plugin.

Configuration du plugin

Il est absolument nécessaire de renseigner au moins trois propriétés :

• deepl_api_key il s'agit de la clef de connexion à l'API DeepL. Sans cette clef, pas d’appel possible à l’API DeepL donc pas de traduction possible, y compris en mode gratuit (il faut une clef DeepL free pour se connecter)

• glossary_name il s'agit de l'espace de nom pour le stockage des glossaires. Tous les serveurs qui partagent la même valeur pour cette propriété utiliseront les mêmes glossaires. Par défaut, cette proprité est configurée pour être la valeur saisie dans la variable company.name.

• token_auth_key il s'agit de la clef de chiffrement pour les connexion InDesign. Elle doit être identique dans la configuration du plugin InDesign. Si aucune clef n'est renseignée, le plugin InDesign ne pourra pas appeler l'API de traduction et donc pas de traduction possible

Configuration du plugin InDesign

TODO

Gestion des glossaires

Les glossaires sont des listes de couples d’expressions, une expression dans une langue source, et son expression correspondante dans la langue cible. Il en existe un par couple langue source, langue cible.

Ils sont organisés par espace de noms : un serveur est configuré pour utiliser un espace de nom. Tous les serveurs configurés avec le même espace de nom partage les mêmes glossaires.

Importer un glossaire dans DeepL

Pour importer un glossaire dans DeepL vous pouvez passer par la page web à l’URL _plugins/WXM_DEEPL/page/admin/upload.jspz, dans laquelle il vous suffira de glisser-déposer des fichiers d’extension TSV, ou des ZIP contenant de tels fichiers, dans la zone en pointillés. Dans la zone située en dessous, vous obtiendrez les journaux d’imports (avec erreur ou alertes concernant les expressions refusées).

Cette page peut être accèdée depuis le menu situé à l’URL _plugins/WXM_DEEPL/page/admin/home.jspz., via la fonctionnalité :

Il est également possible d’utiliser un end point.

Gérer les glossaires

Si nécessaire, vous pouvez consulter les glossaires présents et éventuellement supprimer les glossaires superflus, ou encore exporter un glossaire, dans la page située à l’URL _plugins/WXM_DEEPL/page/admin/glossaries.jspz.

Cette page peut être accèdée depuis le menu situé à l’URL _plugins/WXM_DEEPL/page/admin/home.jspz., via la fonctionnalité :

Il est également possible d’utiliser des end points dédiés.

Analytics

La page située à l’URL _plugins/WXM_DEEPL/page/admin/dashboards.jspz vous permettra de voir la consommation en caractères traduits par DeepL pour les utilisateurs de votre serveur, et en particulier pour les requêtes provenant de InDesign pour votre serveur.

Cette page peut être accèdée depuis le menu situé à l’URL _plugins/WXM_DEEPL/page/admin/home.jspz., via la fonctionnalité :

BillingHits

A destination d’esaas pour la facturation, le endpoint /api/wedia/deepl/billingHits donnera accès au compteur de caractères traduits sur le serveur concerné, donc pour le client concerné. Les paramètres sont les mêmes que pour l'API api/wedia/analytics/admin/billingHits.

Traduction : utiliser la fonction de traduction InDesign

TODO

Statut DeepL

Evidemment le service DeepL de traduction automatique doit être opérationnel pour que la traduction autmatiquement fonctionne. Vous pouvez obtenir directement le statut de l’API via l’URL https://www.deeplstatus.com/.

Cette page peut être accèdée depuis le menu situé à l’URL _plugins/WXM_DEEPL/page/admin/home.jspz., via la fonctionnalité :