Gettext

Переводите целевые значения PO, сохраняя контекст сообщений и идентификаторы исходного текста и учитывая ограничения восстановления форм множественного числа.

В Gettext исходный текст и перевод хранятся в одной записи. Обработчик файлов po читает msgid и записывает перевод в msgstr, оставляя исходный текст на месте. Он также использует msgctxt, чтобы различать одинаковые слова в разных ситуациях.

Контекст помогает различать сообщения #

Например, в этих записях слово «Back» может переводиться по-разному:

text
msgctxt "checkout navigation"
msgid "Back"
msgstr ""

msgctxt "product surface"
msgid "Back"
msgstr ""

Это отдельные единицы, хотя значение msgid у них одинаковое. Контекст также передаётся как подсказка для перевода. Строки комментариев и флагов сохраняются вместе с записями. Но это не означает, что каждый комментарий обрабатывается как инструкция или что флаги проверки обновляются.

Специализированный парсер обрабатывает поддерживаемые поля PO в кавычках и строки продолжения. Используйте входные файлы в UTF-8: парсер не преобразует произвольные устаревшие кодировки. Автоматическое обнаружение .pot не входит в гарантии CLI по определению .po.

Ограничения восстановления форм множественного числа #

В записи с формами множественного числа msgid и msgid_plural становятся отдельными текстовыми единицами для единственного и множественного числа. Обработчик создаёт как минимум два поля перевода. Если в существующем переводе полей больше, неизменённые записи сохраняют утверждённые формы. Когда меняется любая из первых двух форм перевода, в дополнительные поля записывается новое значение множественного числа, а не отдельно сгенерированные формы.

Перед компиляцией проверьте формы множественного числа в результате. Для языка с несколькими разными формами нужен правильный текст в каждом поле и соответствующий заголовок Plural-Forms. Обработчик отдаёт предпочтение существующим заголовкам перевода. При первом формировании результата он переносит исходный заголовок, меняя Language на целевую локаль. Обработчик не переписывает Plural-Forms под целевой язык.

Обновления и сериализация #

Предыдущая версия исходного текста позволяет определить изменения по контексту, идентификатору сообщения и единице единственного или множественного числа. Сохраняемые значения msgstr берутся из существующих записей перевода. Если идентификатор исходного текста изменится, сообщение может считаться новым, даже если его утверждённый перевод всё ещё подходит.

При восстановлении сохраняются исходные поля, строки комментариев и оформление записей, а значения msgstr и соответствующий заголовок заменяются. Форматирование значений перевода в кавычках может измениться. Не ограничивайтесь разбором файла: проверяйте также количество сообщений и метаданные форм множественного числа.

Настройте и скомпилируйте каталог #

CLI определяет po по .po. Выберите исходные каталоги через конфигурацию CLI или GitHub.

Скомпилируйте или импортируйте результат с помощью инструментов Gettext вашего приложения. Затем проверьте формы для разных количеств и поиск сообщений с учётом контекста. Проверяйте повторяющиеся значения форм множественного числа и заголовки, даже если файл успешно разбирается: от них зависит, что приложение покажет для каждого количества.