mirror of
https://github.com/wagtail/wagtail.git
synced 2024-11-30 01:46:24 +01:00
48 lines
1.6 KiB
ReStructuredText
48 lines
1.6 KiB
ReStructuredText
.. _simple_translation:
|
|
|
|
Simple translation
|
|
==================
|
|
|
|
The simple_translation module provides a user interface that allows users to copy pages and translatable snippets into another language.
|
|
|
|
- Copies are created in the source language (not translated)
|
|
- Copies of pages are in draft status
|
|
|
|
Content editors need to translate the content and publish the pages.
|
|
|
|
.. note::
|
|
Simple Translation is optional. It can be switched out by third-party packages. Like the more advanced `wagtail-localize <https://github.com/wagtail/wagtail-localize>`_.
|
|
|
|
|
|
Basic configuration
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
Add ``"wagtail.contrib.simple_translation"`` to INSTALLED_APPS in your settings file:
|
|
|
|
.. code-block:: python
|
|
|
|
INSTALLED_APPS = [
|
|
...
|
|
"wagtail.contrib.simple_translation",
|
|
]
|
|
|
|
Run ``python manage.py migrate`` to create the necessary permissions.
|
|
|
|
In the Wagtail admin, go to settings and give some users or groups the "Can submit translations" permission.
|
|
|
|
|
|
Page tree synchronisation
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Depending on your use case, it may be useful to keep the page trees in sync between different locales.
|
|
|
|
You can enable this feature by setting `WAGTAILSIMPLETRANSLATION_SYNC_PAGE_TREE` to `True`.
|
|
|
|
.. code-block:: python
|
|
|
|
WAGTAILSIMPLETRANSLATION_SYNC_PAGE_TREE = True
|
|
|
|
When this feature is turned on, every time an editor creates a page, Wagtail creates an alias for that page under the page trees of all the other locales.
|
|
|
|
For example, when an editor creates the page "/en/blog/my-blog-post/", Wagtail creates an alias of that page at "/fr/blog/my-blog-post/" and "/de/blog/my-blog-post/".
|