Як користуватися Poedit: Повний посібник (2026)
Якщо ви коли-небудь відкривали файл .po у звичайному текстовому редакторі, ви вже знаєте це відчуття. Сотні пар msgid та msgstr, розкидані повсюди прапорці «fuzzy» (нечіткі), і всього один неправильний натиск клавіші може зламати весь каталог. Є кращий спосіб, і вже понад десять років стандартною відповіддю є та сама настільна програма: Poedit.
Цей посібник з Poedit розкаже вам про все: від встановлення програми до компіляції вашого першого файлу .mo. Незалежно від того, чи перекладаєте ви тему WordPress, плагін або власний проєкт на основі Gettext, Poedit надає вам чистий візуальний редактор, який приховує сирий формат файлу та дозволяє зосередитися на самій роботі з перекладом.
До кінця цього посібника ви зрозумієте інтерфейс Poedit, дізнаєтеся, як розпочати переклад з шаблону .pot, використовувати пам’ять перекладів (Translation Memory) для прискорення роботи та точно розпізнаєте, де безкоштовний настільний інструмент перестає бути ефективним, щоб знати, коли натомість звернутися до хмарного робочого процесу.
Що таке 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 для вас.
Прапорці «Fuzzy» та кольори стану
Poedit кодує рядки кольором, щоб ви могли швидко оцінити стан каталогу. Неперекладені рядки виділяються, а «fuzzy» (нечіткі) рядки – записи, позначені у файлі як #, fuzzy через зміну вихідного тексту або автоматичне співпадіння перекладу – відображаються окремим кольором (зазвичай помаранчевим або жовтим). «Fuzzy» рядки по суті є прапорцями «потребує перегляду». WordPress не відображатиме їх на робочому сайті, тому їх очищення має значення. Ви можете перемикати стан «fuzzy» для будь-якого рядка одним ярликом, як тільки ви підтвердите правильність перекладу.
Рядок стану внизу показує ваш прогрес: загальна кількість рядків, скільки перекладено, і скільки залишаються «fuzzy» або неперекладеними.
Нижня панель редагування також надає корисний контекст. Вона показує коментар з посиланням на вихідний код, рядок коду, де використовується рядок (наприклад, #: 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 автоматично зберігає вашу позицію, тому ви можете закрити програму посеред каталогу і продовжити саме там, де зупинилися. Для великих каталогів комбінації клавіш для переходу до наступного неперекладеного або наступного «fuzzy» рядка дозволяють рухатися без прокручування, де більшість часу втрачається при ручному редагуванні.
Пам’ять перекладів та різниця між безкоштовною та Pro версіями
Однією з найкорисніших функцій Poedit є Пам’ять перекладів (TM). Під час перекладу Poedit запам’ятовує кожну пару вихідний текст-переклад. Наступного разу, коли з’явиться ідентичний або схожий вихідний рядок, у тому ж файлі або в іншому проєкті, Poedit автоматично запропонує ваш попередній переклад. За кілька місяців роботи це перетворюється на особисту базу даних, яка значно прискорює переклад повторюваних елементів інтерфейсу, таких як «Save» (Зберегти), «Cancel» (Скасувати) та «Add to cart» (Додати до кошика).
Пропозиції TM з’являються на панелі редагування, і ви можете прийняти їх натисканням клавіші. Зверніть увагу, що записи, заповнені за допомогою TM, часто за замовчуванням позначаються як «fuzzy», тому вам слід переглянути їх перед зняттям прапорця.
Що додає Poedit Pro?
Безкоштовний редактор повністю забезпечує ручний переклад. Poedit Pro (платне оновлення) додає дві ключові функції:
- Сканування вихідного коду: Pro може сканувати ваш вихідний код PHP або JavaScript, знаходити кожен виклик Gettext
__()та_e(), і витягувати новий файл.potабо оновлювати існуючий каталог, без необхідності використання командного рядка. - Попередній переклад: Pro пропонує машинний попередній переклад для всього каталогу, але він працює за платною, кредитною моделлю. Ви купуєте кредити, і великі каталоги швидко їх споживають.
Для однієї мови та скромного каталогу Pro є зручним. Справжнє обмеження — це масштаб. Кредити на попередній переклад накопичуються, а робочий процес все ще принципово передбачає один файл, одну мову, одну настільну сесію за раз.
Також варто чітко розуміти, що робить і чого не робить пам’ять перекладів (TM). 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за лічені хвилини, з Syntax Locking на кожному рядку.