A Django app which provides support for model translation.
Project description
Translations provides an easy and efficient way of translating model contents.
Requirements
Python (>=3.5) - Python 2.7 is NOT supported.
Django (1.11, 2.0) - Django 2.1 is NOT supported (yet).
Installation
Install Translations using PIP (use --pre, still in development):
$ pip install --pre django-translations
Add 'translations' to INSTALLED_APPS in the settings of your Django project:
INSTALLED_APPS = [ ... 'translations', ... ]
Run migrate:
$ python manage.py migrate
Usage
Model
Inherit Translatable in any model you want translated.
No migrations needed afterwards! That’s it!
from translations.models import Translatable class Question(Translatable): ... class Choice(Translatable): ...
Query
You can use the extended ORM querysets:
>>> q = Question.objects.create_translated( ... question_text="What's up?", ... category='usuals', ... lang='en' ... ) <Question: What's up?> >>> q.question_text = 'Quoi de neuf?' >>> q.category = 'habituels' >>> q.update_translations( ... lang='fr' ... ) >>> q.get_translated(lang='en') <Question: What's up?> >>> q.get_translated(lang='fr') <Question: Quoi de neuf?>
Admin
You can also use the admin extensions:
from django.contrib import admin from translations.admin import TranslatableAdmin, TranslationInline from .models import Question class QuestionAdmin(TranslatableAdmin): inlines = [TranslationInline,] admin.site.register(Question, QuestionAdmin)
Documentation
For more interesting capabilities browse through the documentation.
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
Built Distribution
Hashes for django-translations-1.0.0.dev2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | e337f8c4669ce91ff1d8f00b712ca4f5fa16600ad864ec8430a4dc3aec499296 |
|
MD5 | 45bea395eeae687ba4aca94aab315315 |
|
BLAKE2b-256 | 3db316fd2dc6dd7ae0b2bee4b9d01855d15078d90425c2fd05734bba24e9de26 |
Hashes for django_translations-1.0.0.dev2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 66998cb57ae78cc211a901ea05940327bce7e65d08f272757a1e48a54c044156 |
|
MD5 | 2066b792b44f177967f664c0ec5dcd17 |
|
BLAKE2b-256 | 9e664d49027be739e0ce67c04437fc9741b7f9556491c99e27873db6c6843dc7 |