Помечайте строки для перевода, используя функцию _(). (Да, имя функции — символ нижнего подчеркивания). Для подключения этой функции используйте:

from django.utils.translation import gettext_lazy as _

В этом примере, текст, «Welcome to my site.» помечен для перевода:

def my_view(request):
    output = _("Welcome to my site.")
    return HttpResponse(output)

Функция django.utils.translation.gettext() идентична _(). Этот пример эквивалентен предыдущему:

from django.utils.translation import gettext
def my_view(request):
    output = gettext("Welcome to my site.")
    return HttpResponse(output)

Большинство разработчиков используют _(), так как она короче.

Механизм переводов работает и для вычисляемых значений. Этот пример идентичен двум предыдущим:

def my_view(request):
    words = ['Welcome', 'to', 'my', 'site.']
    output = _(' '.join(words))
    return HttpResponse(output)

Механизм переводов работает и для переменных. И снова идентичный пример:

def my_view(request):
    sentence = 'Welcome to my site.'
    output = _(sentence)
    return HttpResponse(output)

(Недостаток использования переменных или вычисляемых значений, как показано в предыдущих двух примерах, в том, что стандартная утилита поиска текста подлежащего переводу, make-messages.py, не сможет найти такие строки. Подробности по этой утилите будут дальше.)

Строки, передаваемые в _() или gettext(), могут содержать символы подстановки, указанные в соответствии со стандартом языка Python, например:

def my_view(request, n):
    output = _('%(name)s is my name.') % {'name': n}
    return HttpResponse(output)

Эта технология позволяет осуществлять перевод, привязанный к особенностям языка, перемещая символы подстановки в тексте. На пример, строка на английском «Adrian is my name.», может переведена на испанский как «Me llamo Adrian.», используя символ подстановки установленный после переводимого текста, а не перед ним.

По этой причине, вы должны использовать именованную подстановку вместо позиционной (%s или %d). Если вы используете позиционную подстановку, переводчик не сможет поменять местами подстановки.

Используйте функцию django.utils.translation.gettext_noop() для того, чтобы отметить строки для перевода, но без осуществления перевода в данный момент. Строки помеченный таким образом не переводятся до самого последнего момента.

Используйте этот подход, если у вас есть неизменные строки, которые должны быть сохранены на оригинальном языке — такие как строки в базе данных — но которые должны быть переведены в последний момент, например, когда строка показывается пользователю.

Используйте функцию django.utils.translation.gettext_lazy() для отложенного перевода строк — это когда значение получают до того, как будет вызвана функция.

Например, для пометки атрибута поля help_text как подлежащего переводу сделайте следующее:

from django.utils.translation import gettext_lazy

class MyThing(models.Model):
    name = models.CharField(help_text=gettext_lazy('This is the help text'))

В данном примере функция gettext_lazy() сохраняет отложенную ссылку на строку, а не её перевод. Сам перевод будет выполнен в момент использования строки, например, при обработке шаблона на сайте администратора Django.

Если вам не нравится длинное имя функции, вы можете использовать _ (символ подчёркивания), вот так:

from django.utils.translation import gettext_lazy as _

class MyThing(models.Model):
    name = models.CharField(help_text=_('This is the help text'))

Всегда используйте отложенные переводы в моделях (иначе они не будут переведены корректно для каждого отдельного пользователя). Будет хорошей идеей добавлять перевод к именам полей и таблиц тоже. Это означает, что необходимо явно указывать опции verbose_name и verbose_name_plural в классе Meta:

from django.utils.translation import gettext_lazy as _

class MyThing(models.Model):
    name = models.CharField(_('name'), help_text=_('This is the help text'))
    class Meta:
        verbose_name = _('my thing')
        verbose_name_plural = _('mythings')

Используйте функцию django.utils.translation.ngettext() для определения сообщений, которые имеют различные формы единственного и множественного числа, например:

from django.utils.translation import ngettext
def hello_world(request, count):
    page = ngettext(
        'there is %(count)d object',
        'there are %(count)d objects', count
    ) % {'count': count}
    return HttpResponse(page)

Функция ngettext() принимает три аргумента: строку для единственного числа, строку для множественного числа и количество объектов (которые передаются языку перевода в виде переменной count.