Metadata-Version: 2.1
Name: wagtail-localize
Version: 0.9.3
Summary: Translation plugin for Wagtail CMS
Home-page: UNKNOWN
Author: Karl Hobley
Author-email: karl@kaed.uk
License: BSD
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Framework :: Wagtail :: 2
Description-Content-Type: text/markdown
Requires-Dist: Django (<3.2,>=2.2)
Requires-Dist: Wagtail (<2.12,>=2.11)
Requires-Dist: polib (<2.0,>=1.1)
Provides-Extra: testing
Requires-Dist: dj-database-url (==0.5.0) ; extra == 'testing'
Requires-Dist: freezegun (==0.3.15) ; extra == 'testing'

# Wagtail localize

Supported versions:

Python: 3.7 and 3.8
Django: 2.2, 3.0 and 3.1
Wagtail: 2.11

## Installation and setup

Install with pip:

```shell
pip install wagtail-localize
```

### Settings modifications

Add `wagtail_localize` and `wagtail_localize.locales` to `INSTALLED_APPS` in `settings/base.py`:

```python
INSTALLED_APPS = [
    ...
    "wagtail_localize",
    "wagtail_localize.locales",  # Note: This replaces "wagtail.locales"
    ...
]
```

Add the following to `MIDDLEWARE`:

```python
"django.middleware.locale.LocaleMiddleware",
```

Ensure your settings file has:

```python
LANGUAGE_CODE = "en-gb"  # Or your preferred default language
USE_I18N = True
```

Add to following to your settings specifying any languages you would like to translate:

```python
LANGUAGES = [
    ("en", "English"),
    ("fr", "French"),
]
```

To enable DeepL as a machine translator, add the following to your settings:

```python
WAGTAILLOCALIZE_MACHINE_TRANSLATOR = {
    'CLASS': 'wagtail_localize.machine_translators.deepl.DeepLTranslator',
    'OPTIONS': {
        'AUTH_KEY': '<Your DeepL key here>',
    }
}
```

### URL configuration

The following additions need to be made to `./yoursite/urls.py`

```python
from django.conf.urls.i18n import i18n_patterns
...

urlpatterns += i18n_patterns(
    url(r"^search/$", search_views.search, name="search"),
    url(r"", include(wagtail_urls)),
)
```



