Machine translation setup¶
The source langauge can be configured by SOURCE_LANGUAGE and is shared for all translations within Weblate.
Special installation of tmserver run by Virtaal authors.
To enable this service, add trans.machine.tmserver.AmagamaTranslation to MACHINE_TRANSLATION_SERVICES.
A free/open-source machine translation platform providing translation to limited set of languages.
You should get API key from them, otherwise number of requests is rate limited.
To enable this service, add trans.machine.apertium.ApertiumTranslation to MACHINE_TRANSLATION_SERVICES.
Free dictionary and translation memory for almost every living language.
API is free to use, regarding indicated data source license. There is a limit of call that may be done from one IP in fixed period of time, to prevent from abuse.
To enable this service, add trans.machine.glosbe.GlosbeTranslation to MACHINE_TRANSLATION_SERVICES.
Machine translation service provided by Google.
This service uses Translation API and you need to obtain API key and enable billing on Google API console.
To enable this service, add trans.machine.google.GoogleTranslation to MACHINE_TRANSLATION_SERVICES.
Google Web Translate¶
Machine translation service provided by Google.
Please note that this does not use official Translation API but rather web based translation interface.
To enable this service, add trans.machine.google.GoogleWebTranslation to MACHINE_TRANSLATION_SERVICES.
Machine translation service provided by Microsoft.
You need to register at Azure market and use Client ID and secret from there.
To enable this service, add trans.machine.microsoft.MicrosoftTranslation to MACHINE_TRANSLATION_SERVICES.
Huge translation memory with machine translation.
Free, anonymous usage is currently limited to 100 requests/day, or to 1000 requests/day when you provide contact email in MT_MYMEMORY_EMAIL. you can also ask them for more.
To enable this service, add trans.machine.mymemory.MyMemoryTranslation to MACHINE_TRANSLATION_SERVICES.
Database of open source translations.
To enable this service, add trans.machine.opentran.OpenTranTranslation to MACHINE_TRANSLATION_SERVICES.
You can run your own translation memory server which is bundled with Translate-toolkit and let Weblate talk to it. You can also use it with amaGama server, which is enhanced version of tmserver.
First you will want to import some data to the translation memory:
To enable this service, add trans.machine.tmserver.TMServerTranslation to MACHINE_TRANSLATION_SERVICES.
build_tmdb -d /var/lib/tm/db -s en -t cs locale/cs/LC_MESSAGES/django.po build_tmdb -d /var/lib/tm/db -s en -t de locale/de/LC_MESSAGES/django.po build_tmdb -d /var/lib/tm/db -s en -t fr locale/fr/LC_MESSAGES/django.po
Now you can start tmserver to listen to your requests:
tmserver -d /var/lib/tm/db
And configure Weblate to talk to it:
MT_TMSERVER = 'http://localhost:8888/'
Weblate can be source of machine translation as well. There are two services to provide you results - one does exact search for string, the other one finds all similar strings.
First one is useful for full string translations, the second one for finding individual phrases or words to keep the translation consistent.
To enable these services, add trans.machine.weblatetm.WeblateSimilarTranslation (for similar string matching) and/or trans.machine.weblatetm.WeblateTranslation (for exact string matching) to MACHINE_TRANSLATION_SERVICES.
For similarity matching, it is recommended to have Whoosh 2.5.2 or later, earlier versions can cause infinite looks under some occasions.
Custom machine translation¶
You can also implement own machine translation services using few lines of Python code. Following example implements translation to fixed list of languages using dictionary Python module:
# -*- coding: utf-8 -*- # # Copyright © 2012 - 2014 Michal Čihař <[email protected]> # # This file is part of Weblate <http://weblate.org/> # # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program. If not, see <http://www.gnu.org/licenses/>. # ''' Machine translation example. ''' from weblate.trans.machine.base import MachineTranslation import dictionary class SampleTranslation(MachineTranslation): ''' Sample machine translation interface. ''' name = 'Sample' def download_languages(self): ''' Returns list of languages your machine translation supports. ''' return set(('cs',)) def download_translations(self, language, text, unit, request): ''' Returns tuple with translations. ''' return [(t, 100, self.name, text) for t in dictionary.translate(text)]
You can list own class in MACHINE_TRANSLATION_SERVICES and Weblate will start using that.