Оптимизация локализации в WordPress с помощью команды wp i18n в CLI

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

Создание POT файла с помощью wp i18n make-pot

Создание .pot файла для ваших плагинов или тем WordPress является важным шагом в интернационализации. Этот файл необходим для определения всех строк, требующих перевода. Команда wp i18n make-pot позволяет легко генерировать такие файлы.

$ wp i18n make-pot . languages/my-custom-plugin.pot

Этот пример сканирует текущую директорию на наличие переводимых строк и создает файл my-custom-plugin.pot в папке languages.

Опции make-pot

$ wp i18n make-pot . translations/textdomain.pot --domain=textdomain

С помощью опции --domain="textdomain" можно указать, какой текстовый домен искать, если не используется опция --ignore-domain.

Извлечение JavaScript строк с wp i18n make-json

Поскольку строки JavaScript также могут нуждаться в переводе, команда wp i18n make-json помогает извлекать их из .po файлов и конвертировать в .json файлы.

$ wp i18n make-json translations -no-purge

Пример показывает, как создать .json файлы из всех .po файлов в каталоге translations. Опцию --no-purge можно использовать для сохранения строк JavaScript в исходных .po файлах.

Преобразование файлов с wp i18n make-mo

Для оптимальной работы с переводами на сервере файлы .po могут быть преобразованы в .mo, что позволяет WordPress быстро выполнять перевод. Команда wp i18n make-mo создает бинарные .mo файлы из текстовых .po файлов.

$ wp i18n make-mo ./resources/languages/

Этот пример конвертирует все .po файлы в папке resources/languages в .mo.

Обновление PO файлов с wp i18n update-po

С обновлением переводов связан процесс обновления ваших .po файлов, чтобы они отражали любые изменения в .pot файлах. Это можно выполнить с помощью команды wp i18n update-po.

$ wp i18n update-po path/to/my-plugin.pot path/to/translations

Здесь my-plugin.pot это исходный .pot файл, а translations — папка, содержащая обновляемые .po файлы.

Преобразование в PHP файлы с wp i18n make-php

Создание PHP файлов из .po файлов может быть выполнено с помощью команды wp i18n make-php. Это позволяет использовать переводы непосредственно в PHP скриптах.

$ wp i18n make-php path/to/translations

Таким образом, можно преобразовать .po файлы в PHP файлы в указанной директории.

Заключение

Команда wp i18n в WP-CLI значительно упрощает управление переводами в WordPress. От генерации .pot файлов до управления .po и .mo файлами, она становится незаменимым помощником в процессах интернационализации.