skip to navigation
skip to content

Not Logged In

django-translator 1.0.3

Translator is an app for collecting translations for specified keys in django admin.

===========
Translator
===========

Translator is an app for collecting translations for specified keys in django admin.

Quick start
-----------

1. Add "translator, taggit, modeltranslation" to your INSTALLED_APPS setting like this::

INSTALLED_APPS = (
...
'taggit',
'modeltranslation',
'translator',

)

#. You have to set the migrations folder for the translator, because we have to add migrations for the set languages. (More informations on the `South documentation <http: south.readthedocs.org="" en="" latest="" settings.html#south-migration-modules="">`_.) Add the following to your settings file:

SOUTH_MIGRATION_MODULES = {
'translator': 'my_project.migrations.translator',
}

#. Create a ``migrations`` python package in your project folder (where your settings.py usually is).


#. Run ``python manage.py schemamigration translator --initial`` to create the translator models based on the languages you specified in your settings file.

#. Run ``python manage.py migrate`` to migrate the translator models to your database.

#. If you intend to use it in the templates, add 'translator.context_processors.translator' to TEMPLATE_CONTEXT_PROCESSORS ::

TEMPLATE_CONTEXT_PROCESSORS = (
...
'translator.context_processors.translator',
)

#. Create translation keys in your templates and models.

Examples:

Template::

{{ translator.a_key }}

models.py::

from translator.util import translator_lazy as _
...

class Product(models.Model):
name = models.TextField(verbose_name=_(u"a_key"))

#. Visit the templates. The keys get collected lazy.

#. Translate the keys in the admin.


Project Home
------------
https://github.com/dreipol/django-translator

PyPi
------------
https://pypi.python.org/pypi/django-translator  
File Type Py Version Uploaded on Size
django-translator-1.0.3.tar.gz (md5) Source 2014-11-27 5KB
  • Downloads (All Versions):
  • 4 downloads in the last day
  • 49 downloads in the last week
  • 236 downloads in the last month