Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ankitpopli1891/django-autotranslate

A simple Django app to automatically translate the pot (.po) files generated by django's makemessages command using google translate.
https://github.com/ankitpopli1891/django-autotranslate

django internationalization localization python

Last synced: about 16 hours ago
JSON representation

A simple Django app to automatically translate the pot (.po) files generated by django's makemessages command using google translate.

Awesome Lists containing this project

README

        

django-autotranslate
====================

A simple Django app to automatically translate the pot (`.po`) files generated by django's makemessages command
using google translate.

[![][travis-ci]][travis] [![][pypi-version]][pypi] ![][requirements]

Installation:
-------------

```bash
pip install django-autotranslate
```

Add ``'autotranslate'`` to your ``INSTALLED_APPS`` setting.

```python
INSTALLED_APPS = (
...
'autotranslate',
)
```

Quickstart:
-----------

```bash
python manage.py translate_messages
```

The command finds all the generated pot (``.po``) files under the locale paths (``LOCALE_PATHS``) specified in django project settings, and translates them automatically.

Options:
--------

- ``-f, --set-fuzzy``: Set the 'fuzzy' flag on autotranslated entries
- ``-l, --locale 'locale'``: Only translate the specified locales
- ``-u, --untranslated``: Only translate the untranslated messages
- ``-s, --source-language``: Override the default source language (en) used for translation

```bash
python manage.py translate_messages -l 'de' -l 'es'
```

Settings:
---------

- Use a different Translation Service:

```python
# default: 'autotranslate.services.GoSlateTranslatorService'
# pip install google-api-python-client
AUTOTRANSLATE_TRANSLATOR_SERVICE = 'autotranslate.services.GoogleAPITranslatorService'
GOOGLE_TRANSLATE_KEY = ''
```

Compatibility Matrix:
--------------------

| autotranslate | django |
| :-----------: | :---------: |
| v1.0.x | Django 1.5+ |
| v1.1.x | Django 1.8+ |

Tests:
-----

```bash
# run test against all environments
tox
# run test against a specific environment defined in tox.ini
# eg. django>1.9 & python3.4
tox -e dj19-py34
```

[travis-ci]: https://travis-ci.org/ankitpopli1891/django-autotranslate.svg?branch=master
[travis]: https://travis-ci.org/ankitpopli1891/django-autotranslate

[pypi-version]: https://img.shields.io/pypi/v/django-autotranslate.svg
[pypi]: https://pypi.python.org/pypi/django-autotranslate/

[requirements]: https://requires.io/github/ankitpopli1891/django-autotranslate/requirements.svg?branch=master