Перевод Модулей

В этом разделе объясняется, как предоставить возможности для перевода вашему модулю.

Экспорт переводимых терминов

Ряд терминов в ваших модулях «переводится неявно», даже если вы не выполнили какую-либо конкретную работу по переводу, то после экспорта терминов вашего модуля вы, скорее всего, найдете контент над которым надо еще поработать.

Экспорт переводов осуществляется через интерфейс администратора(нужно войти в режим отладки) и открытия Settings ‣ Translations ‣ Import / Export ‣ Export Translations

  • Оставьте язык по умолчанию (новый язык/пустой шаблон)
  • Выберите формат PO File
  • выберите свой модуль
  • нажмите Export и загрузите файл

Это даст вам файл с именем ваш_модуль.pot, который должен быть помещен в каталог ваш_модуль/i18n/. Файл представляет собой Шаблон PO файла, который просто перечисляет переводимые строки и из которых могут быть созданы фактические переводы (PO-файлы). PO-файлы могут быть созданы с помощью msginit, с помощью специального инструмента перевода, такого как POEdit, или путем простого копирования шаблона в новый файл с именем language.po. Файлы перевода должны быть перенесены в директорию ваш_модуль/i18n/, рядом с файлом ваш_модуль.pot, и они будут автоматически загружены Odoo при установке соответствующего языка (через Settings ‣ Translations ‣ Load a Translation)

Экспорт неявных терминов

Odoo автоматически экспортирует переводимые строки из содержимого типа «data»:

  • В представлениях, отличных от QWeb, экспортируются все текстовые узлы, а также атрибуты string, help, sum, confirm и placeholder
  • Шаблоны QWeb (как на стороне сервера, так и на стороне клиента), все текстовые узлы экспортируются, кроме блоков t-translation = "off", также экспортируются содержимое атрибутов title, alt , label и placeholder

  • для Field, если их модель не отмечена _translate = False:

    • экспортируются атрибуты string и help
    • если selection присутствует и его список (или кортеж) экспортируется
    • если их атрибут translate установлен в True, все их существующие значения (во всех записях) экспортируются
  • сообщения о помощи и об ошибках _constraints и _sql_constraints экспортируются

Экспорт очевидных терминов

Когда дело доходит до более «императивных» ситуаций в коде Python или коде Javascript, Odoo не может автоматически экспортировать термины для перевода, поэтому для экспорта они должны быть отмечены явно. Это делается путем обертки литеральной строки в вызов функции.

В Python функция враппер - odoo._():

title = _("Bank Accounts")

В JavaScript функция враппер обычно odoo.web._t():

title = _t("Bank Accounts");

Ленивая версия _ и _t is odoo._lt() в python и odoo.web._lt() в javascript соотвественно. Поиск перевода выполняется только при рендеринге и может использоваться для объявления переводимых свойств в методах класса глобальных переменных.

Переменные

Неправильно* извлечение переменно может работать, а вот корректность перевода не гарантируется:

_("Scheduled meeting with %s" % invitee.name)

Правильно установить переменную за областью видимости функции перевода:

_("Scheduled meeting with %s") % invitee.name

Блоки

Неправильно разделять ваш перевод на несколько блоков или несколько строк:

# bad, trailing spaces, blocks out of context
_("You have ") + len(invoices) + _(" invoices waiting")
_t("You have ") + invoices.length + _t(" invoices waiting");

# bad, multiple small translations
_("Reference of the document that generated ") + \
_("this sales order request.")

Правильно держать в одном блоке, предоставляя полный контекст для переводчиков:

# good, allow to change position of the number in the translation
_("You have %s invoices wainting") % len(invoices)
_.str.sprintf(_t("You have %s invoices wainting"), invoices.length);

# good, full sentence is understandable
_("Reference of the document that generated " + \
  "this sales order request.")

Множественное число

Нправильно использовать множественное число по-английски:

msg = _("You have %s invoice") % invoice_count
if invoice_count > 1:
  msg += _("s")

Правильно держать в голове, что каждый язык имеет различные формы множественного числа:

if invoice_count > 1:
  msg = _("You have %s invoices") % invoice_count
else:
  msg = _("You have %s invoice") % invoice_count

Read vs Run Time

Неправильно вызвать поиск перевода при запуске сервера:

ERROR_MESSAGE = {
  # bad, evaluated at server launch with no user language
  'access_error': _('Access Error'),
  'missing_error': _('Missing Record'),
}

class Record(models.Model):

  def _raise_error(self, code):
    raise UserError(ERROR_MESSAGE[code])

Неправильно вызывать поиск перевода при чтении файла JavaScript:

# bad, js _t is evaluated too early
var core = require('web.core');
var _t = core._t;
var map_title = {
    access_error: _t('Access Error'),
    missing_error: _t('Missing Record'),
};

Правильно использовать ленивый метод поиска перевода:

ERROR_MESSAGE = {
  'access_error': _lt('Access Error'),
  'missing_error': _lt('Missing Record'),
}

class Record(models.Model):

  def _raise_error(self, code):
    # translation lookup executed at error rendering
    raise UserError(ERROR_MESSAGE[code])

или правильно динамически оценивать переводимый контент:

# good, evaluated at run time
def _get_error_message(self):
  return {
    access_error: _('Access Error'),
    missing_error: _('Missing Record'),
  }

Правильно когда поиск перевода выполняется, в момент чтения файл JS , используйте _lt вместо ``_t``чтобы перевести термин в момент использования:

# good, js _lt is evaluated lazily
var core = require('web.core');
var _lt = core._lt;
var map_title = {
    access_error: _lt('Access Error'),
    missing_error: _lt('Missing Record'),
};