Skip to content

Latest commit

 

History

History
53 lines (38 loc) · 3.1 KB

Automatic-Translations.md

File metadata and controls

53 lines (38 loc) · 3.1 KB

Automated Translations

To speed up the localization process you can make use of automated translations.

Usage

Switch to the Translate tab to use this feature.

If the translation service needs credentials, enter them in the translation engine configuration. Follow the link to the translation service to learn about the service specifics. If you don't want to use a service, uncheck the check box next to the name.

After selecting source and target language, all entires that have no translation in the target language will be displayed and the translation runs in the background. When the translation is complete, the results can be reviewed or edited before accepting the result.

All results can be reviewed by opening the combo box in the target column. The results are ordered by the quality of the translation that the service reports. If you had already a translation of the same term in your project, the quality is the number of occurrences of this translation. Existing translations will have a higher quality rank than translations by a service.

Translations

Azure Open AI

Pros

  • Much more context aware
  • Higher quality translations, especially when fed with at least two different languages when translating to third/fourth/etc languages
  • Ability to use comments to guide the model
  • Better understanding of placeholders (such as {0}), seems to put them in better locations

Cons

  • Most models are slower, or much slower, than the other translation services
  • More expensive (depending on your token cost at Azure)

Configuration

  • Add a new Azure OpenAI resource using the portal or CLI.
  • Model availability may vary depending on e.g. region, check the model availabilty here
  • Deploy the "gpt-3.5-turbo-instruct" (completion based) or "gpt-3.5-turbo"/"gpt-4-turbo" (chat based) model.
  • Copy the API key, URL to the endpoint and name of the deployment and model into the settings of the translator

Addtional Settings

  • You can add a custom prompt to your request to improve the translation quality or behavior, e.g. "preserve the html tags in the results"
  • You can include the comments in your resources in the prompt, to guide the model with additional hints about the context

Open AI

Pros

  • Same az Azure Open AI

Cons

  • Same as Azure Open AI but with a different pricing model
  • No batched translation support

Configuration

  • Go to here to sign up and get an API key from here
  • Copy the API key and a model of your choosing (e.g. "gpt-3.5-turbo"/"gpt-4-turbo") into the settings of the translator

Addtional Settings

  • You can add a custom prompt to your request to improve the translation quality or behavior, e.g. "preserve the html tags in the results"
  • You can include the comments in your resources in the prompt, to guide the model with additional hints about the context