Перевод темы для Wordpress
Posted on 1 сентября 2008Вопрос перевода (интернационализации) темы для Wordpress с завидным постоянством возникает в умах авторов блогов. И если одним посчастливилось работать уже переведенной темой, то другим приходится довольствоваться оригинальной темой на родном языке ее автора.
Я попытаюсь рассказать, на примере как правильно переводить любую тему, не зависимо от того, как автор подготовил ее к этому.
Начнем с рассмотрения уже существующих источников о переводе. На русском языке есть хороший рассказ у Делитанта, там же приведены еще две хороших ссылки. Тем не менее, полного руководства, насколько я знаю, нет.
В качестве примера возьмем тему Default из стандартной поставки — она, как ни странно, совершенно не пригодна к интернационализации. Папка темы в дистрибутиве Wordpress располагается по пути wp-content\themes\default. Создайте отдельную папку для проекта перевода и скопируйте в нее указанную папку default полностью.
Первичная подготовка
Тема совершенно не подготовлена — весь смысловой текст просто прописан в исходных текстах. Первой стадией подготовки будет оформление такого текста в специальные функции библиотеки интернационализации gettext. Функция __(’строка‘, ‘домен’) возвращает переведенную строку для модуля, уникально обозначенного словом домен, а функция _e(’строка‘, ‘домен’) делает то же самое, только не возвращает, а сама печатает перевод.
Домен — специальное слово, которым необходимо помечать отдельные от основного модуля (которым в нашем случае выступает сам Wordpress) модули программы (в нашем случае это тема). Предлагаю выбрать “default-theme” в качестве домена.
В нашем случае весь «простой» текст для перевода мы будем заключать в тег <?php _e(’<строка>‘, ‘default-theme’); ?>, а текст в функциях (по сути тот, который уже заключен в теги <?php … ?>) в функцию __(’<строка>’, ‘default-theme’). Работы будет много, все зависит от объема темы и текста в ней. Будьте внимательны — если не уверены, лучше не трогать текст сразу, чем сломать тему и потом долго искать ошибку. Если текст содержит символ ‘ его нужно экранировать при помещении в вышеуказанные тег или функцию. Для этого просто замените его на \’.
Таким образом, вам необходимо будет проработать все *.php файлы в каталоге темы и сделать в них изменения. Советую делать это с помощью какого-нибудь редактора для программистов типа Scintilla или Notepad++ — он вам значительно облегчит работу, а подсвеченный код не даст запутаться.
Специально для примера я изменил соответствующим образом файлы темы. Типовые замены приведены на рисунках.
Первоначальный вариант
После изменений
Изменив, таким образом, исходные файлы темы мы подготовили их к следующему этапу — из них необходимо «извлечь» весь текст, который в дальнейшем будет переводиться.
Для того, чтобы Wordpress начал использовать наш перевод необходимо в начало файла functions.php, на следующей строке после строки содержащей текст «<?php» (она 99,9% первая) добавить следующий текст:
load_theme_textdomain(’default-theme’);
Получение шаблона перевода
Для дальнейшей работы нам понадобиться программа Poedit, поэтому скачайте ее и установите на компьютер. Работу с программой приведу по шагам с помощью скриншотов и кратких комментариев.
1. Создаем новый каталог перевода
2. Вводим основную информацию о переводе
3. Задаем информацию о путях. Путь к базе — полный путь к папке, в которую вы поместили папку с темой. В список добавляем название папки с файлами темы, она называется default
4. Задаем ключевые слова — названия функций отвечающих за интернализацию
5. Нажимаем ОК. Программа предложит сохранить .po файл. Сохраняйте его в папке, заданной на шаге 3 как путь к базе. В результате вы должны увидеть список найденных программой фраз к переводу. Список будет пустым или возникнут ошибки, если вы что-то сделали неправильно, в таком случае начните снова с шага 1
После того, как файл с фразами для перевода создан, можно воспользоваться руководством Делетанта начиная с пункта 2.
Удачной вам интернационализации и будьте здоровы! 
Еще по теме локализации:
Codex: Internationalizing Your Plugin
Codex: Translating WordPress
Ryan Boren: Localizing Plugins and Themes
Расписал всё здорово. Именно так по уму и нужно переводить темы. Получается долго, зато результат качественный. А то уж очень много в сети мусора.