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

Description

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.

Usage

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:

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.

Configuration

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

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

• org.xwiki.contrib.glossary:application-glossary-ui 1.5.1
• org.xwiki.contrib.glossary:application-glossary-machine-translation-api 1.5.1
• org.xwiki.contrib.machinetranslation:machine-translation-ui 1.1.1