Как использовать Poedit: Полное руководство (2026)

Если вы когда-либо открывали файл .po в обычном текстовом редакторе, вы уже знакомы с этим чувством. Сотни пар msgid и msgstr, "нечеткие" флаги, разбросанные повсюду, и одно неверное нажатие клавиши, которое может испортить весь каталог. Есть лучший способ, и уже более десяти лет стандартным решением является одно и то же настольное приложение: Poedit.

Это руководство по Poedit охватывает все, от установки приложения до компиляции вашего первого файла .mo. Независимо от того, переводите ли вы тему WordPress, плагин или свой собственный проект на основе Gettext, Poedit предоставляет вам чистый визуальный редактор, который скрывает необработанный формат файла и позволяет сосредоточиться на самой работе по переводу.

К концу этого руководства вы поймете интерфейс Poedit, узнаете, как начать перевод из шаблона .pot, использовать память переводов для ускорения работы и точно поймете, где бесплатный настольный инструмент перестает быть эффективным, чтобы вы знали, когда вместо него следует использовать облачный рабочий процесс.

Что такое Poedit и как его установить?

Poedit — это бесплатный кроссплатформенный настольный редактор для файлов переводов Gettext (.po, .pot и скомпилированных .mo). Он работает на macOS, Windows и Linux и является наиболее широко рекомендуемой отправной точкой для всех, кто редактирует каталоги переводов вручную.

Установка проста. Перейдите на официальный сайт Poedit и загрузите установщик для вашей операционной системы или используйте менеджер пакетов.

# macOS (Homebrew)
brew install --cask poedit

# Debian / Ubuntu
sudo apt install poedit

# Windows (winget)
winget install Poedit.Poedit

Бесплатная версия полностью покрывает основные возможности редактирования. Существует платная версия Poedit Pro, которая добавляет сканирование исходного кода и предварительный перевод, что мы рассмотрим позже. Пока что бесплатной загрузки достаточно, чтобы открывать и редактировать любой каталог.

Если вы хотите получить более широкий обзор инструментов редактирования, прежде чем принимать решение, наш обзор лучших бесплатных инструментов для редактирования и перевода файлов PO на Mac и Windows сравнивает Poedit с основными альтернативами.

Понимание интерфейса Poedit

Когда вы открываете файл .po (Файл, затем Открыть, или просто перетаскиваете файл в окно), Poedit представляет трехзонный макет, который напрямую соответствует базовой структуре Gettext.

Панели источника и перевода

Основная область представляет собой двухколоночный список. Левый столбец показывает исходную строку (msgid) точно так, как ее написал разработчик в коде. Правый столбец показывает ваш перевод (msgstr). Щелчок по любой строке загружает ее в панель редактирования внизу, где вы вводите переведенный текст.

Рассмотрим эту необработанную запись внутри файла:

#: includes/checkout.php:142
msgid "Your order has been placed."
msgstr ""

В Poedit та же запись отображается как одна строка: источник слева, пустая ячейка для перевода справа. Вы никогда не касаетесь необработанного синтаксиса. Вы просто вводите текст в нижнюю панель, и Poedit записывает msgstr для вас.

Нечеткие флаги и цветовые обозначения статуса

Poedit раскрашивает строки так, чтобы вы могли с первого взгляда оценить состояние каталога. Непереведенные строки выделяются, а нечеткие строки (записи, помеченные как #, fuzzy в файле, потому что источник изменился или перевод был автоматически подобран) отображаются другим цветом (обычно оранжевым или желтым). Нечеткие строки — это, по сути, флаги "требует проверки". WordPress не будет отображать их на работающем сайте, поэтому их устранение важно. Вы можете переключать состояние "нечеткости" для любой строки с помощью одной горячей клавиши, как только подтвердите правильность перевода.

Строка состояния внизу показывает ваш прогресс: общее количество строк, сколько переведено и сколько остаются "нечеткими" или непереведенными.

Нижняя панель редактирования также предоставляет полезный контекст. Она показывает комментарий-ссылку на источник, строку кода, где используется строка (например, #: includes/checkout.php:142), и любые заметки разработчика, оставленные в файле. Эти комментарии бесценны, когда короткая строка, такая как "Order" (Заказ/Заказать), может быть существительным или глаголом; ссылка на источник сообщает вам, к какому файлу и функции она относится, чтобы вы перевели ее правильно с первого раза. Несколько секунд, потраченных на чтение этого контекста, — это разница между точным каталогом и каталогом, полным неловких, неуместных фраз.

Как начать новый перевод из файла POT?

Файл .pot — это шаблон, содержащий все исходные строки с пустыми переводами. Чтобы начать совершенно новый язык, вы создаете .po из этого шаблона, а не редактируете .pot напрямую.

В Poedit выберите Файл, затем Новый из файла POT/PO, выберите .pot темы или плагина (обычно внутри его папки /languages) и выберите целевой язык. Затем Poedit запросит язык и сгенерирует новый каталог с правильным соглашением об именовании файла, например de_DE.po для немецкого языка.

Настройка заголовка каталога и множественных форм

Каждый файл .po содержит блок заголовка, и наиболее важным полем для корректности является Plural-Forms. Это выражение указывает Gettext, сколько вариантов множественного числа требуется языку и какой из них выбрать для данного числа.

"Plural-Forms: nplurals=2; plural=(n != 1);\n"

В английском языке используются две формы. Языкам, таким как польский и русский, требуется три или более, и неправильно установленный заголовок приводит к грамматически неверному исчислению. Poedit устанавливает разумное значение по умолчанию при выборе языка, но вы можете просмотреть и отредактировать его в меню Каталог, затем Свойства. Если вы хотите глубже понять, почему этот заголовок так легко ошибочно настроить, обратитесь к нашему руководству по множественным числам Gettext и сложным правилам плюрализации.

Свойства каталога также позволяют установить имя проекта, имя и адрес электронной почты переводчика, команду языка и кодировку символов. Кодировка символов почти всегда должна быть UTF-8; все остальное рискует повредить символы с диакритикой и нелатинские шрифты. Poedit по умолчанию использует UTF-8 для новых файлов, но если вы наследуете старый каталог, стоит это проверить. Правильная настройка заголовка в самом начале избавит вас от повторной работы позже.

После настройки вы просто работаете со списком, переводя каждую строку. Poedit автоматически сохраняет вашу позицию, поэтому вы можете закрыть приложение в середине работы над каталогом и продолжить точно с того места, где остановились. Для длинных каталогов сочетания клавиш для перехода к следующей непереведенной или следующей "нечеткой" строке позволяют вам двигаться без прокрутки, где в ручном редактировании теряется большая часть времени.

Память переводов и различие между бесплатной и Pro-версиями

Одна из самых полезных функций Poedit — Память Переводов (TM). Во время перевода Poedit запоминает каждую пару "источник-перевод". В следующий раз, когда появится идентичная или похожая исходная строка в том же файле или другом проекте, Poedit автоматически предложит ваш предыдущий перевод. За месяцы работы это превращается в персональную базу данных, которая значительно ускоряет работу с повторяющимися строками пользовательского интерфейса, такими как "Сохранить", "Отменить" и "Добавить в корзину".

Предложения TM появляются на панели редактирования, и вы можете принять их нажатием клавиши. Обратите внимание, что записи, заполненные TM, часто по умолчанию помечаются как "нечеткие", поэтому вы должны проверить их, прежде чем снимать флаг.

Что добавляет Poedit Pro?

Бесплатный редактор полностью справляется с ручным переводом. Poedit Pro (платное обновление) добавляет две основные функции:

• Сканирование исходного кода: Pro может сканировать ваш исходный код PHP или JavaScript, находить каждый вызов Gettext __() и _e() и извлекать свежий .pot или обновлять существующий каталог без использования командной строки.
• Предварительный перевод: Pro предлагает машинный предварительный перевод для всего каталога, но работает по платной, кредитной модели. Вы покупаете кредиты, и большие каталоги быстро их расходуют.

Для одного языка и скромного каталога Pro удобен. Честное ограничение — это масштаб. Кредиты на предварительный перевод накапливаются, а рабочий процесс по-прежнему остается принципиально одним файлом, одним языком, одной сессией на рабочем столе за раз.

Также стоит четко понимать, что Память Переводов делает и чего не делает. TM предлагает только те переводы, которые вы (или общая база данных команды) создавали ранее. Для совершенно нового проекта без истории память пуста, поэтому она ничего не предлагает, пока вы не переведете значительную часть вручную. TM ускоряет повторяющиеся и встречающиеся строки; она не переводит совершенно новый контент. Это различие имеет значение, когда вы оцениваете, сколько времени займет новый каталог, потому что первый язык всегда самый медленный, и каждый последующий язык начинается с чистого листа, если только его строки не пересекаются.

Сохранение работы и компиляция MO-файлов

Почему WordPress нужен файл .mo, если вы редактировали только .po? Потому что WordPress читает скомпилированный бинарный .mo во время выполнения, а не удобочитаемый .po. Хорошая новость в том, что Poedit справляется с этим автоматически.

Когда вы нажимаете Сохранить, Poedit записывает .po и по умолчанию компилирует соответствующий .mo в той же папке.

# After saving in Poedit you get both files:
wp-content/languages/themes/
  storefront-de_DE.po   # editable source
  storefront-de_DE.mo   # compiled binary WordPress loads

Если при сохранении не создается файл .mo, проверьте Настройки, затем Общие и убедитесь, что включена опция "Автоматически компилировать MO-файл при сохранении". Отсутствие или устаревший файл .mo является одной из наиболее распространенных причин, по которым готовый перевод никогда не появляется на работающем сайте. Если вы столкнулись с этой проблемой, наше руководство по устранению неполадок, связанных с не отображением переводов в WordPress, содержит полный контрольный список.

Когда Poedit недостаточно: масштабирование за пределы настольного компьютера

Poedit отлично справляется со своей задачей: это точный, ручной, однофайловый редактор. Трудности возникают, как только ваши потребности растут. Перевод одного плагина на двенадцать языков означает двенадцать отдельных сессий. Каталог размером 10 МБ с тысячами строк означает часы набора текста или сжигание кредитов на предварительный перевод. А ручное редактирование всегда несет риск ошибки с плейсхолдером, таким как %s или %1$s, и скрытого нарушения вывода.

Именно здесь на смену приходит облачный рабочий процесс. SimplePoTranslate обрабатывает ваш каталог с помощью контекстно-ориентированного ИИ с блокировкой синтаксиса (Syntax Locking), которая замораживает каждый %s, %1$s, {name} и HTML-тег, чтобы структура никогда не нарушалась во время перевода. Умное пакетирование (Smart Batching) обрабатывает файлы размером более 10 МБ без ручного разделения, и вы получаете результат в виде готового к развертыванию ZIP-архива, содержащего .po, .mo, .json, .php и .xliff одновременно, все это в облаке без установки на рабочий стол и без лишних функций.

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

Готовы перевести целые каталоги на десятки языков, не тратя часы на настольный редактор? Попробуйте SimplePoTranslate бесплатно — кредитная карта не требуется. Бесплатный тариф позволяет перевести ваш первый файл .po за считанные минуты с включенной функцией блокировки синтаксиса для каждой строки.