Wagtail Translate adds machine translations to your Wagtail site, with built-in support for DeepL and the flexibility to integrate other translation services. It automatically detects when a page is copied to a new locale and initiates the translation process.
Wagtail Localize and Wagtail Simple Translation are the go-to solutions for multi-language Wagtail projects. Wagtail Localize offers advanced features that may be excessive for many projects, while Wagtail Simple Translation only copies pages to new locales, requiring manual translation.
Wagtail Translate adds machine translations to Wagtail. It works in combination with Simple Translation, offering the ideal solution for projects seeking a simple interface with powerful translation support.
- Python 3.8 - 3.12
- Django 4.2 - 5.0
- Wagtail 5.2 - 6.0
You need to configure your project for authoring content in multiple languages. See Wagtail documentation on internationalization.
In summary:
# settings.py
USE_I18N = True
WAGTAIL_I18N_ENABLED = True
USE_L10N = True
LANGUAGE_CODE = 'en'
WAGTAIL_CONTENT_LANGUAGES = LANGUAGES = [
(LANGUAGE_CODE, "English"),
('fr', "French"),
]
INSTALLED_APPS += [
"wagtail.locales",
"wagtail.contrib.simple_translation",
]
MIDDLEWARE += [
'django.middleware.locale.LocaleMiddleware',
]
# urls.py
from django.conf.urls.i18n import i18n_patterns
urlpatterns += i18n_patterns(
path("", include(wagtail_urls)),
)Create the French locale at: /admin/locales/new/.
python -m pip install wagtail-translateINSTALLED_APPS = [
"wagtail_translate",
"wagtail_translate.default_behaviour",
...
]
WAGTAIL_TRANSLATE_TRANSLATOR = "wagtail_translate.translators.rot13.ROT13Translator"In the Wagtail admin interface, go to the homepage, in the dot-dot-dot-menu, choose "Translate".
The contents should be translated! 🥳
The installation example uses the ROT13Translator. It shifts each letter by 13 places.
Applying it twice will return the text to its original form.
ROT13 is good for testing and evaluation, but not for real-world use.
Wagtail Translation has a DeepL translator. Install and configure it as follows:
pip install deepl- Get a DeepL API key from https://www.deepl.com/pro#developer
- Add
WAGTAIL_TRANSLATE_DEEPL_KEY = "..."to your settings. - Set
WAGTAIL_TRANSLATE_TRANSLATOR = "wagtail_translate.translators.deepl.DeepLTranslator"
- This readme for installation and basic usage.
- How to customise Wagtail Translate
- Explanation
To make changes to this project, first clone this repository:
git clone https://github.com/allcaps/wagtail-translate.git
cd wagtail-translateWith your preferred virtualenv activated, install testing dependencies:
python -m pip install --upgrade pip
python -m pip install -e '.[testing]' -Upython -m pip install flit
flit installNote that this project uses pre-commit. It is included in the project testing requirements. To set up locally:
# go to the project directory
cd wagtail-translate
# initialize pre-commit
pre-commit install
# Optional, run all checks once for this, then the checks will run only on the changed files
git ls-files --others --cached --exclude-standard | xargs pre-commit run --filesNow you can run tests as shown below:
toxor, you can run them for a specific environment tox -e python3.11-django4.2-wagtail5.1 or specific test
tox -e python3.11-django4.2-wagtail5.1-sqlite wagtail-translate.tests.test_file.TestClass.test_method
To run the test app interactively, use tox -e interactive, visit http://127.0.0.1:8000/admin/ and log in with admin/changeme.
This project has been created with Cruft, a drop-in replacement for Cookiecutter.
cruft create git@github.com:wagtail/cookiecutter-wagtail-package.gitThe "cookiecutter answers" are stored in .cruft.json. To update the project to the latest template, run:
cruft update