/django-datatrans

Translate Django models without changing anything to existing applications and their underlying database.

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

django-datatrans
================

By Jef Geskens; City Live nv

FEATURES
--------

* Translate Django models without changing anything to existing applications and their underlying database.
* Uses a registration approach.
* All translations are stored in one extra lookup table. Existing database tables remain untouched.
* Recovery and cleanup of obsolete translations.
* Translation admin interface included (uses CSS from django admin).
* Transparent model API (in 99% of all cases, nothing has to be changed to original code).
* Infinite caching for all strings (based on id and hash)

HOW TO USE
----------

1. Add it to INSTALLED_APPS
2. Syncdb
3. Register models (example for FlatPage model):

    from datatrans.utils import register

    class FlatPageTranslation(object):
        fields = ('title', 'content',)

    register(FlatPage, FlatPageTranslation)

4. Include the datatrans.urls in your urlconf somewhere, and point your browser to it!
5. Translate away!