Machine Translation Glossary Application

Last modified by slauriere on 2024/07/05 17:40

cogTurns a Glossary to a Machine Translation Glossary which can then be used by the Machine Translation Application
Developed by

slauriere, Clément Aubin, Josué Tille

1 Votes
LicenseGNU Lesser General Public License 2.1

Installable with the Extension Manager


This application allows to turn Glossaries into Machine Translation Glossaries so that they can be used by the Machine Translation Application to control how each glossary entry is translated in other languages.


The first step is to translate each glossary entry into the languages supported by the wiki.

Translation of glossary entries

First create a glossary entry in the original language as described in the Glossary Application documentation. Then, translate the entry using the translation dropdown menu exposed by the Machine Translation Application, and update the translation to your own specific translation:


When new glossary translations are created, the glossary needs to be synchronized with the remote Machine Translation Service before it can be used for content translation. This can be done from the Glossary home page as illustrated below.


Translation of pages using the glossary

Once the glossary entries have been translated and the glossary synchronization has been performed, you can translate content harnessing the glossary: the Machine Translation Application will automatically use the translated glossary entries when they are available.

Viewing the available Machine Translation Glossaries

Aministrators can view the Machine Translation Glossaries registed in the Machine Translation service by hitting the button "Translation Glossaries Explorer" in section "Content" > "Machine Translation" of the administration module:


Here's below an illustration of the Translation Glossaries Explorer: it lists see all glossaries registered in the Machine Translation service. Hitting a glossary link allows to display all entries it contains.


This Explorer also lists all language pairs supported by the remote Machine Translation service. Note that the language pair supported by the Machine Translation Application for the glossary feature may be different than for the translation without a glossary.


The settings for this application can be controled from "Administration > Content > "Machine Translation". A specific glossary name prefix can be set: this can be useful in particular when using multiple wikis with a common Machine Translation API token in order to avoid conflicts between glossaries, since each Machine Translation Glossary name must be unique.


Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.

You can also use the following manual method, which is useful if this extension cannot be installed with the Extension Manager or if you're using an old version of XWiki that doesn't have the Extension Manager:

  1. Log in the wiki with a user having Administration rights
  2. Go to the Administration page and select the Import category
  3. Follow the on-screen instructions to upload the downloaded XAR
  4. Click on the uploaded XAR and follow the instructions
  5. You'll also need to install all dependent Extensions that are not already installed in your wiki


Dependencies for this extension (org.xwiki.contrib.glossary:application-glossary-machine-translation-ui 1.5.1):

Get Connected