Installation¶
Download / Installation¶
The easiest way to get and install Django Translation Manager is via pip, feel free to omit the first two lines if you don’t want to use virtualenv
virtualenv env --no-site-packages
source env/bin/activate
pip install django-translation-manager
In case you are curious about the source, willing to contribute, or you just want to do it yourself, feel free to see our GitHub project page
After you have installed the package, it’s time for configuration
Configuratuion¶
- First, add translation_manager to INSTALLED_APPS to your project’s settings in settings.py.
We’re calling our project project for example’s sake
INSTALLED_APPS = ( 'django.contrib.admin', 'django.contrib.auth', # ... # this is what we have added: 'translation_manager', )
- Next, add the following variables to your settings and set them accordingly
# Required paths to all locale dirs LOCALE_PATHS = [] # Path to project basedir / workdir - root folder of project # TRANSLATIONS_BASE_DIR = os.path.dirname(os.path.dirname(__file__)) TRANSLATIONS_BASE_DIR = '' # Language to display in hint column to help translators # see translation of string in another language TRANSLATIONS_HINT_LANGUAGE = ''
- add post_save signal to restart the server:
from translation_manager.signals import post_save as translation_post_save translation_post_save.connect(restart_server, sender=None)
- use syncdb or migrate
./manage.py syncdb ./manage.py migrate
- Now load strings from .po files via python shell
./manage.py shell
from translation_manager.manager import Manager m = Manager() m.load_data_from_po()
- if you need, add a link to translation admin
{% url admin:translation_manager_translationentry_changelist %}
You should now have your Django Translation Manager up and running