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 : Setting up the Deepl Bridge Plugin .

Configuration du plugin

Il est absolument nécessaire de renseigner au moins trois propriétés This page briefly explains the basic functions of the Deepl API machine translation plugin. For more details, go to Setting up the DeepL Bridge Plugin.

Plugin configuration

At least three properties must be filled in:

• 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 this is the API connection key DeepL. Without this key, no call to the DeepL API is possible, so no translation is possible, even in free mode (you need a DeepL free key to connect).
  

  Status
  title 2024.2

  If no value is specified, the Wedia key is used.

• glossary_name this is the namespace for storing glossaries. All servers sharing the same value for this property will use the same glossaries. By default, this property is configured to be the value entered in the company.name variable.

• 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

...

• key this is the encryption key for InDesign connections. It must be identical in the InDesign plugin configuration. If no key is entered, the InDesign plugin will not be able to call the translation API, so no translation will be possible.

Configuring the WXM_ANALYTICS_V2 plugin

Analytics graphics are integrated into the "New analytics" page. When a menu list is explicitly specified for a role in the configuration of this plugin (parameter available_menus), it is necessary to add the translation value to access it.

Configuring the InDesign plugin

In the wedia.cfg file, in the /wedia/pref section (associated with a prefix), add a server entry with the following attributes:

• key: the encryption key for the connection token (the value of plugin parameter token_auth_key)

• url: the server url

Example :

<?xml version="1.0" encoding="UTF-8"?>
<wedia>
	<!--Specific functional parameters for prefix dcw-->
	<pref prefix="dcw">
		<server key="***********" url="https://dev-club-wed.wedia-group.com"/>
	</pref>
</wedia>

Glossary management

Glossaries are lists of pairs of expressions: one expression in a source language, and its corresponding expression in the target language. There is one for each source and target language pair.

They are organized by namespace: a server is configured to use one namespace. All servers configured with the same namespace share the same glossaries.

Import a glossary into DeepL

To import a glossary into DeepL you can go to the web page at the 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 where you simply drag and drop TSV extension files, or ZIPs containing such files, into the dotted area. In the area below, you'll see the import logs (with errors or alerts concerning rejected expressions).

This page can be accessed from the menu at URL _plugins/WXM_DEEPL/page/admin/home.jspz., via la fonctionnalité the following feature:

...

Il est également possible d’utiliser un It is also possible to use an end point.

Gérer les glossaires

...

Managing glossaries

If needed, you can view the current glossaries and delete any superfluous ones, or export a glossary, in the page located at the URL _plugins/WXM_DEEPL/page/admin/glossaries.jspz.

Cette page peut être accèdée depuis le menu situé à l’URL This page can be accessed from the menu at URL _plugins/WXM_DEEPL/page/admin/home.jspz., via la fonctionnalité the following feature:

...

Il est également possible d’utiliser des Dedicated end points dédiéscan also be used.

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

...

Direct access to administration interface

The interface functionalities menu page can be accessed directly from the engine administration menu:

...

Translation: using the InDesign translation function

See Translation service (DeepL).

DeepL Services Status

Of course, the DeepL machine translation service must be up and running for automatic translation to work. You can obtain the API status directly from the URL https://www.deeplstatus.com/.

Cette page peut être accèdée depuis le menu situé à l’URL This page can be accessed from the menu at URL _plugins/WXM_DEEPL/page/admin/home.jspz., via la fonctionnalité the following feature:

...