MS Azure Autotranslator

For the most up-to-date documentation, please visit docs.brix.ch

No UI

The "MS Azure Autotranslator" plugin automatically translates nodes (on creation, move and metadata update) and assets (on metadata update and add to node) within the defined scope.

Warning: to prevent the translation of a lot of assets or nodes that were already translated, only the moved node is translated (if in scope) and not its children or the assets in it. You can either trigger changes for the fields that should be translated, or run the auto translator task (important: set the scope(s) accordingly, everything in any scope will be translated (again)).

Properties

To be configured in {home}/appserver/conf/custom.properties.

See here for the configuration in general and the compatibility matrix.

autoTranslator.translationService

type: String, required: yes, default: -

Set this to "microsoft".

autoTranslator.microsoft.url

type: String, required: yes (if the microsoft service was selected), default: -

The URL to the microsoft translation service, e.g. https://api.cognitive.microsofttranslator.com/translate?api-version=3.0.

autoTranslator.microsoft.subscriptionKey

type: String, required: yes (if the microsoft service was selected), default: -

The subscription key delivered by Microsoft (see Installation).

autoTranslator.microsoft.region

type: String, required: yes (if the microsoft service was selected and not global url is used), default: -

The region in which the translation subscription was created.

Installation

  1. Create a Microsoft Azure account and sign in
  2. Switch to the portal
  3. Go to "all resources"
  4. Click "add"
  5. Enter "Translator Text" in the search box and then select from the results
  6. Select "create" to define the details for the subscription
  7. From the Pricing tier list, select the pricing tier that best fits your needs (up to 2.5M characters/month are free)
  8. Fill out the descriptive fields and click "create" to finish the subscription
  9. Go to "all resources" and open the subscription just created
  10. Click on "keys" and copy one of the keys into your properties file: autoTranslator.microsoft.subscriptionKey