0
0
mirror of https://github.com/wagtail/wagtail.git synced 2024-11-22 11:07:57 +01:00
wagtail/docs/reference/contrib/simple_translation.md
Buraah bfa29201c3 Docs - Page names & reference section - Update British spelling to American
- Changed all British spellings to American spellings, in the Customizing admin templates section of the docs
- Transferred all British spellings in the usage guide and advanced topics section to American spellings
- Update a series of other pages to use the spelling cutomize in the file name
Implemented all feedbacks on the usage guide and advanced topics section
2024-02-12 08:44:19 +10:00

1.5 KiB

(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.

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:

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 synchronization

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.

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/".