Django app for managing translations from admin
Project description
######
README
######
.. image:: https://travis-ci.org/COEXCZ/django-translation-manager.svg
:target: https://travis-ci.org/COEXCZ/django-translation-manager
:alt: Travis
.. image:: https://landscape.io/github/COEXCZ/django-translation-manager/master/landscape.svg?style=flat
:target: https://landscape.io/github/COEXCZ/django-translation-manager/master
:alt: Code Health
.. image:: https://img.shields.io/pypi/v/django-translation-manager.svg
:target: https://pypi.python.org/pypi/django-translation-manager/
:alt: PYPI
.. image:: https://readthedocs.org/projects/django-translation-manager/badge/?version=master
:target: http://django-translation-manager.readthedocs.org/en/master/
:alt: Read the docs
Install package
===============
* use pip to get the package
::
pip install django-translation-manager
* add 'translation_manager' to settings.py: INSTALLED_APPS
* add variables from Translation Manager's defaults.py to your settings.py
* add post_save signal to restart webserver:
::
from translation_manager.signals import post_save as translation_post_save
translation_post_save.connect(restart_server, sender=None)
Supported versions of django
============================
We support all django versions greater or equal 1.8.
Using with django-rq
====================
We support asynchronous translation processing by django-rq.
Set translation processing method in settings.py
::
TRANSLATIONS_PROCESSING_METHOD = 'async_django_rq'
Inslall django-rq
::
pip install django_rq
Install django-redis-cache
::
pip install django-redis-cache
We tested it with django-rq 0.9.1 and django-redis-cache 1.6.5
For configuration django_rq see https://github.com/ui/django-rq
Using with Angularjs
====================
We support translation for Angularjs client-site app via REST api
Enable api communication in settings
::
TRANSLATIONS_ENABLE_API_COMMUNICATION = True
Enable searching for translation strings in Angularjs source codes
::
TRANSLATIONS_ENABLE_API_ANGULAR_JS = True
Set path to Anguraljs source code files.
The important thing is that it must be in the same file system.
Configuration example:
::
TRANSLATIONS_API_CLIENT_APP_SRC_PATH = '/var/srv/front/src'
Add regex for matching translation strings in client app src files:
::
TRANSLATIONS_API_TRANSLATION_STRINGS_REGEX = r''
Inslall django REST framewrok
::
pip install djangorestframework
Add translation manager urls in your url patterns
::
from translation_manager import urls as translation_urls
urlpatterns.append(url(r'^translations/', include(translation_urls)))
We tested it with django-rest-framework 3.4.6
SyncDB
======
use syncdb
::
./manage.py syncdb
or migrate:
::
./manage.py migrate
Load strings from po files
==========================
via python shell
::
./manage.py shell
from translation_manager.manager import Manager
m = Manager()
m.load_data_from_po()
Add link to translation admin
=============================
this is optional in case you need it
::
{% url admin:translation_manager_translationentry_changelist %}
Known bugs
==========
If you are using different base site you have to register admin to your site.
License note
============
Django Translation Manager is available under Mozilla Public License 2.0
http://choosealicense.com/licenses/mpl-2.0/
Donate
======
.. image:: https://img.shields.io/badge/paypal-donate-yellow.svg
:target: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=PUQZRR48HXXDC
Thank you!
----------
We really appreciate every donation that helps us take Django Translation Manager to the next level.
README
######
.. image:: https://travis-ci.org/COEXCZ/django-translation-manager.svg
:target: https://travis-ci.org/COEXCZ/django-translation-manager
:alt: Travis
.. image:: https://landscape.io/github/COEXCZ/django-translation-manager/master/landscape.svg?style=flat
:target: https://landscape.io/github/COEXCZ/django-translation-manager/master
:alt: Code Health
.. image:: https://img.shields.io/pypi/v/django-translation-manager.svg
:target: https://pypi.python.org/pypi/django-translation-manager/
:alt: PYPI
.. image:: https://readthedocs.org/projects/django-translation-manager/badge/?version=master
:target: http://django-translation-manager.readthedocs.org/en/master/
:alt: Read the docs
Install package
===============
* use pip to get the package
::
pip install django-translation-manager
* add 'translation_manager' to settings.py: INSTALLED_APPS
* add variables from Translation Manager's defaults.py to your settings.py
* add post_save signal to restart webserver:
::
from translation_manager.signals import post_save as translation_post_save
translation_post_save.connect(restart_server, sender=None)
Supported versions of django
============================
We support all django versions greater or equal 1.8.
Using with django-rq
====================
We support asynchronous translation processing by django-rq.
Set translation processing method in settings.py
::
TRANSLATIONS_PROCESSING_METHOD = 'async_django_rq'
Inslall django-rq
::
pip install django_rq
Install django-redis-cache
::
pip install django-redis-cache
We tested it with django-rq 0.9.1 and django-redis-cache 1.6.5
For configuration django_rq see https://github.com/ui/django-rq
Using with Angularjs
====================
We support translation for Angularjs client-site app via REST api
Enable api communication in settings
::
TRANSLATIONS_ENABLE_API_COMMUNICATION = True
Enable searching for translation strings in Angularjs source codes
::
TRANSLATIONS_ENABLE_API_ANGULAR_JS = True
Set path to Anguraljs source code files.
The important thing is that it must be in the same file system.
Configuration example:
::
TRANSLATIONS_API_CLIENT_APP_SRC_PATH = '/var/srv/front/src'
Add regex for matching translation strings in client app src files:
::
TRANSLATIONS_API_TRANSLATION_STRINGS_REGEX = r''
Inslall django REST framewrok
::
pip install djangorestframework
Add translation manager urls in your url patterns
::
from translation_manager import urls as translation_urls
urlpatterns.append(url(r'^translations/', include(translation_urls)))
We tested it with django-rest-framework 3.4.6
SyncDB
======
use syncdb
::
./manage.py syncdb
or migrate:
::
./manage.py migrate
Load strings from po files
==========================
via python shell
::
./manage.py shell
from translation_manager.manager import Manager
m = Manager()
m.load_data_from_po()
Add link to translation admin
=============================
this is optional in case you need it
::
{% url admin:translation_manager_translationentry_changelist %}
Known bugs
==========
If you are using different base site you have to register admin to your site.
License note
============
Django Translation Manager is available under Mozilla Public License 2.0
http://choosealicense.com/licenses/mpl-2.0/
Donate
======
.. image:: https://img.shields.io/badge/paypal-donate-yellow.svg
:target: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=PUQZRR48HXXDC
Thank you!
----------
We really appreciate every donation that helps us take Django Translation Manager to the next level.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Close
Hashes for django-translation-manager-0.5.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 28dfc95312ae8c261c8214975d8497ed81bfc9bc89d44b51c9f516b3c120e24c |
|
MD5 | 3687eb62cf30f02080d699a87f3325fa |
|
BLAKE2b-256 | 1f4bd42f739ed73f25cb7ec3ab6affbaa6cbfaceb8791dc2239f349e770cb979 |