Интернационализация и локализация django

• 02, 26, 2011
•  bullgare
•  django
• Comments: 17

На примере русского языка.

1. В файл settings.py вписываем:
   
   Go

   LANGUAGE_CODE = 'ru' LANGUAGES = ( ('ru', 'Russian'), ('en', 'English'), ) MIDDLEWARE_CLASSES = ( 'django.middleware.common.CommonMiddleware', 'django.contrib.sessions.middleware.SessionMiddleware', 'django.middleware.locale.LocaleMiddleware', 'django.middleware.csrf.CsrfViewMiddleware', 'django.contrib.auth.middleware.AuthenticationMiddleware', 'django.contrib.messages.middleware.MessageMiddleware', )

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

   LANGUAGE_CODE = 'ru'   LANGUAGES = (   ('ru', 'Russian'),   ('en', 'English'), )   MIDDLEWARE_CLASSES = (     'django.middleware.common.CommonMiddleware',     'django.contrib.sessions.middleware.SessionMiddleware',     'django.middleware.locale.LocaleMiddleware',     'django.middleware.csrf.CsrfViewMiddleware',     'django.contrib.auth.middleware.AuthenticationMiddleware',     'django.contrib.messages.middleware.MessageMiddleware', )

2. Подготавливаем все фразы к переводу.
   Для этого в .py-файлах:
   
   Go

   from django.utils.translation import ugettext as _ ... jsonDict["message"] = _("no data received")

   1 2 3

   from django.utils.translation import ugettext as _ ... jsonDict["message"] = _("no data received")

   
   а в шаблонах есть теги для перевода фраз и многострочного перевода:
   
   Go

   {% load i18n %} {% trans "Login" %} {% blocktrans count object.sets as sets %}{{ sets }} set{% plural %}{{ sets }} sets{% endblocktrans %}

   1 2 3 4 5

   {% load i18n %}   {% trans "Login" %}   {% blocktrans count object.sets as sets %}{{ sets }} set{% plural %}{{ sets }} sets{% endblocktrans %}

   
   Лучше обходиться без начальных и оконечных пробелов, т.к. в противном случае перевод может не подцепиться.

   К сожалению, в каждом шаблоне нужно добавлять загрузку i18n, сразу после тега {% extends «layout.html» %}, почему-то разработчики джанго считают это фичей, видимо, потому что не пользуются).

   Перевод полей модели:

   Go

   from django.utils.translation import ugettext_lazy as _ ... birthday = models.DateField(blank = True, null = True, verbose_name = _('Birthday'))

   1 2 3

   from django.utils.translation import ugettext_lazy as _ ... birthday = models.DateField(blank = True, null = True, verbose_name = _('Birthday'))

   Перевод полей форм:

   Go

   from django.utils.translation import ugettext as _ ... pass1 = forms.CharField(widget = forms.PasswordInput, label = _("Password"), min_length = 6, max_length = 30)

   1 2 3

   from django.utils.translation import ugettext as _ ... pass1 = forms.CharField(widget = forms.PasswordInput, label = _("Password"), min_length = 6, max_length = 30)

3. В корне проекта создаём папку locale
4. Из корня проекта запускаем команду
   Go

   django-admin makemessages -l ru -a

   1	django-admin makemessages -l ru -a

   Команда генерирует файл django.po.
   Сначала идёт заголовок, в котором нет ничего интересного, за исключением следующих строк:

   Go

   "Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && n" "%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n"

   1 2	"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && n" "%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n"

   По этому правилу образовываются формы слов русского языка во множественном числе.
   Дальше следуют пачки вида

   Go

   #: main/views.py:341 msgid "no data received" msgstr "данные не переданы"

   1 2 3

   #: main/views.py:341 msgid "no data received" msgstr "данные не переданы"

   где первая строка — место, где встретилась фраза, помеченная для перевода, вторая строка — фраза, а третья — перевод, который надо вписать.
   Особый случай — переводы, зависящие от числа, к примеру, подходов:

   Go

   #: templates/.../list.html:17 msgid "%(sets)s set" msgid_plural "%(sets)s sets" msgstr[0] "%(sets)s подход" msgstr[1] "%(sets)s подхода" msgstr[2] "%(sets)s подходов"

   1 2 3 4 5 6

   #: templates/.../list.html:17 msgid "%(sets)s set" msgid_plural "%(sets)s sets" msgstr[0] "%(sets)s подход" msgstr[1] "%(sets)s подхода" msgstr[2] "%(sets)s подходов"

   здесь для русского языка нужно задать три фразы — для значения переменной 1, 2 и 5.

5. Скомплировать переводы
   Go

   django-admin.py compilemessages

   1	django-admin.py compilemessages

   По необходимости пункты 4-5 можно повторять, при этом уже введённые переводы не будут потеряны, если фразы, помеченные к переводу, не были удалены.

   Джанго определяет язык пользователя так (если не нашёл, то идёт дальше):

   1. Ищет ключ django_language в сессии пользователя
   2. Ищет в cookies
   3. Ищет в cookies
   4. Ищет Accept-Language в HTTP-заголовках, и пытается отыскать разрешённые в приложении (в переменной LANGUAGES) языки
   5. Использует значение переменной LANGUAGE_CODE

Для смены локали нужно следующее:

1. В urls.py прописать url
   
   Go

   url(r'^i18n/', include('django.conf.urls.i18n')),

   1	url(r'^i18n/', include('django.conf.urls.i18n')),

   
   смена локали будет доступна по адресу /i18n/setlang/
2. Где-нибудь в шаблоне определить форму:
   
   Go

   {% trans 'Change your locale' %}: <form action="/i18n/setlang/" method="POST"> {% csrf_token %} <input name="next" type="hidden" value="/accounts/profile/" /><br/> <select name="language"> {% for lang in LANGUAGES %} <option value="{{ lang.0 }}">{{ lang.1 }}</option> {% endfor %} </select><br/> <input type="submit" value="{% trans 'change' %}" /> </form>

   1 2 3 4 5 6 7 8 9 10 11

   {% trans 'Change your locale' %}: <form action="/i18n/setlang/" method="POST">   {% csrf_token %}   <input name="next" type="hidden" value="/accounts/profile/" /><br/>   <select name="language">     {% for lang in LANGUAGES %}       <option value="{{ lang.0 }}">{{ lang.1 }}</option>     {% endfor %}   </select><br/>   <input type="submit" value="{% trans 'change' %}" /> </form>

Ссылка на официальную документацию по интернационализации django.

Локализация javascript в django

Similar Posts

• Локализация javascript в django