Як перекласти WordPress тему іншою мовою

Не звертати уваги на інші мови при розробці вашої теми WordPress дуже просто, але це погана звичка, і вона миттєво відкидає цілий ринок WordPress користувачів, і потенційні тисячі доларів втраченого прибутку. З ТОП-10 країн, які шукають WordPress теми в Google, лише одна англомовна (США), решти – 9. У момент написання цієї статті в базі даних тем WordPress з більш ніж 1500 тем було всього 269, які позначені як готові до перекладу Тобто всього 18%. Я покажу вам, як зробити вашу тему однією з них.

Як це працює

Зазвичай, коли ви створюєте тему, ви просто пишете безпосередньо в коді будь-який текст теми, наприклад, повідомлення про 404 помилки у файлі 404.php або мітки типу «Коментарі:» aбо «автор». Якщо користувач теми, наприклад, німець або російська, ці частини теми все одно відображатимуться англійською.

Вирішення цього питання – повертати або показувати ці тексти, використовуючи одну з чотирьох функцій WordPress, які розроблені для відсилання до мовному файлу за потрібним текстом. Коли ваш текст містить ці функції, ви можете створити файл, який містить усі переклади, і до якого будуть звертатися щоразу, коли тема завантажується.

Ось три файли перекладів, які ми використовуємо:

• .горщик (Portable Object Template) – шаблон, який містить посилання на кожний рядок тексту у вашій темі, яка потребує перекладу. Файл не містить перекладу. Це типовий текстовий файл.
• .po (Portable Object) – створений з .pot файлу, .po містить усі рядки та їх переклади однією конкретну мову. Це також текстовий файл, який можна редагувати.
• .mo (Machine Object) – бінарна версія .po файлу. При використанні машинного коду файл може використовуватися набагато швидше, ніж текстовий його варіант.

Крок 1. Чотири функції

Кожна з чотирьох функцій вимагає щонайменше один аргумент – текст, який потрібно перекласти. Функції:

• __ () – (два нижні підкреслення) базова функція, яку ви будете використовувати в більшості випадків. Повертає текст правильною мовою.
• _e () – те саме ,що __() , але вона виводить текст замість того, щоб повертати його.
• _n() – використовується, коли текст може бути у множині, наприклад, якщо ви хочете показати, скільки коментарів було залишено, ви можете захотіти вивести «Х відгук» aбо «Х відгуків», Залежно від того, скільки буде коментарів.
• _x() – корисна функція у разі, якщо переклад слова залежить від контексту. «пошта» може означати запис або «розмістити», Залежно від контексту. Для перекладача важливо знати, що ви маєте на увазі, щоб переклад був точним. _x() в основному використовується для окремих слів.

__ () и _e ()

Це найпростіші функції перекладу, які може запропонувати WordPress. Давайте розглянемо приклад для кожної функції:

<?php
if( is_single() ) { //If this is a "post"
	echo __( 'This is a post.' );
}
?>

<?php
if( is_single() ) { //If this is a "post"
	_e( 'This is a post.' );
}
?>

Обидві ці функції роблять те саме. Твердження "this is a postперевіряється на наявність у файлі .mo та повертається результат.

__ () и _e () вимагають лише один аргумент, який їм потрібно передати, – текст для перекладу. Єдина різниця між цими функціями — для __ () потрібен вираз нудьгувати. Давайте розглянемо приклад, де __ () працює краще, ніж _e ():

<?php
the_content( __( 'Click here to read more' ) );
?>

Замість передавати рядок функції _content(), ми використали __ (), щоб текст можна було перекласти. Якби ми використовували натомість _e ()замість того, щоб передати текст у the_content (), Переведення тексту було б виведено в документ, що могло б викликати різного роду неприємності.

_n()

Що, якщо у вас ситуація, коли текст, який ви виводите, може мати множину чи одиничне число, якХ відгуків» у прикладі вище? Замість того, щоб давати два рядки тексту для перекладу, ви можете сказати, що у вас є частина тексту, для якого потрібен переклад у поодинокій і множинні. Наступні два приклади виводять для користувача один і той самий результат:

<?php
if(get_comments_number() == 1) {
	_e( 'There is a comment' );
} else {
	_e( 'There are comments' );
}
?>

<?php
echo _n( 'There is a comment' , 'There are comments' , get_comments_number() );
?>

_n() вимагає три аргументи. Перший – версія тексту в поодинокій кількості, другий – у множині, а третій – кількість, до якої він належить. В даному випадку, get_comments_number() визначає, скільки коментарів є до поста і потім _n() вибирає відповідний текст.

_x() и _ex()

Припустимо, ви перекладаєте .горщик файл і ви проходите повз слово "прокруткиВи інтерпретуєте його як «шматок скрученого паперу» або «прокрутити сайт»? Ви можете використовувати контекст, щоб пояснити, як його потрібно перекладати. Ці функції дадуть вам таку можливість своїм другим обов'язковим атрибутом, який вимагає короткий опис фрази або слова. наприклад:

<?php
echo _x( 'post link' , 'A link to the post' );
_ex( 'post link' , 'Submit a link' );
?>

Приклад показує вам різницю між _x() и _ex(). Це теж e, як у функції _eщо змушує функцію виводити результат замість того, щоб повертати його. Для обох функцій перший параметр – наш текст, який потрібно перекласти, а другий – коментар або замітка про текст, що перекладається, щоб позначити точно, про що йдеться.

Просунуті методики

Припустимо, у нас ситуація, коли текст, який ви хочете генерувати, складається з текстового рядка, який є результатом функції або значення змінної десь усередині неї. Вам, можливо, захочеться написати щось на кшталт такого:

<?php
$color = the_color();
_e( "You have chosen the $color theme" );
?>

Коли ви створюватимете ваш .горщик файл, POEdit проігнорує це, оскільки не хоче використовувати змінну всередині пропозиції. У .горщик файл додасться You have chosen the $color theme, але коли відбуватиметься пошук перекладу, коли скрипт виконується, шукатиметься рядок You have chosen the blue theme, яка не буде знайдена. Ось що ми зробимо:

<?php
$color = the_color();
echo __( 'You have chosen the ' ) . $color . __( ' theme.' );
?>

Таким чином, скрипт зможе отримувати переклади, але тепер стало складніше перекладати, оскільки пропозиція розбита. Ця пропозиція може навіть не мати перекладу деякими мовами, які сильно відрізняються синтаксисом, наприклад, німецькою, де їх переклад слова “вибраний” має бути наприкінці пропозиції. Вам потрібно пояснити, що ці два окремі текстові рядки є частиною одного, і що “тема” може не перекладатися як “тема".

Рішення – використовувати один текстовий рядок. Тут знадобляться функції printf () або sprintf (). Давайте подивимося, на що має бути схожий наш код:

<?php
echo sprintf( __( 'You have chosen the %s theme.' ) , the_color() );
printf( __( 'You have chosen the %s theme.' ) , the_color() );
?>

Це не тільки вирішить нашу проблему, але й буде набагато акуратнішим за виконанням, а також використовує лише один рядок коду. Перший аргумент функцій printf () або sprintf () – рядок для виведення, який включає щонайменше один заповнювач, у даному випадку %s (що означає малий тип “рядок”), а всі інші аргументи – змінні, які треба вставити до початкового рядка.

Є багато різних заповнювачів, які ви можете використовувати всередині рядки, ви можете знайти повний список по спринт в PHP керівництві. Зверніть увагу, що відмінність між printf () и sprintf () подібно до відмінності між _e () и __ () відповідно.

Крок 2. Введення у POEdit

Тепер, коли ви правильно помітили весь текст, що виводиться у вашій темі, вам потрібно зібрати цю інформацію в .горщик файл. POEdit - фантастична програма, яка дає можливість створювати ваш .горщик файл і також надає простий у використанні GUI, який можна використовувати для створення ваших .po і, що ще важливіше, також .mo файлів.

По-перше, вам потрібно скачати POEdit, який ви можете знайти для Windows, Mac і Linux за цій за посиланням.

Коли POEdit встановлено, ви можете створити файл .горщик. Щоб зробити це, перейдіть до File → New Catalog. Ви побачите діалогове вікно, де потрібно буде ввести базові дані. У вкладці "Інформація про проект" - назва проекту та ваша мова/країна. Ви також можете ввести в блоці "Форми множини"наступне:

Форми множини: nplurals = 2; plural=n != 1;

У вкладці "Шляхивведіть шлях, де можуть бути знайдені файли, по відношенню до місця, де лежить цей файл.горщик файл. Наприклад, якщо ви розміщуєте файл .горщик в кореневій папці теми, введіть . (Точку). Якщо ви бажаєте розмістити .горщик файл у папці "мовавсередині кореневої папки теми, введіть .. (Дві точки).

Тепер вам потрібно повідомити POEditякі ключові слова шукати при скануванні наших файлів. Введіть наступне:

• __
• _e
• _n:1,2
• _x:1,2c
• _ex:1,2c

: 1,2  - Вказує POEdit, що ці ключові слова складаються з двох частин. За замовчуванням, другий аргумент – множина, якщо ви не включили c, що означає, що другий аргумент - коментар.

Тепер натискайте «ОК» та вибирайте місце для збереження вашого .горщик файлу. Запам'ятайте, що він повинен співвідноситися із шляхом, який ви визначили раніше. POEdit тепер просканує ваші файли, щоб знайти всі місця, де зустрічаються ваші функції перекладу та збереже їх без перекладу у ваш .горщик файл.

Якщо ви хочете забезпечити мінімальну підтримку міжнародного перекладу, ви можете надати ваш .горщик файл разом з темою та на цьому зупинитися, але якщо ви можете перекласти тему іншою мовою самостійно, ви можете надати свою тему з підготовленим перекладом, як описано на кроці 3.

Крок 3. Переклад та створення свого .po файлу

1. Список всіх рядків для перекладу.
2. Поточний рядок, що перекладається.
3. Ваш переклад рядка.

1. Єдине та множина поточного рядка.
2. Вкладки для перемикання між одниною та множиною.
3. Ваш переклад.

Коли ви переклали всі рядки в .горщик файл, ви можете зберегти це у вашому .po файл. Будь-який рядок, для якого ви не зробили переклад, відображатиметься оригінальною мовою під час перегляду теми.

Назви файлу .po має ключове значення. Отримати текст використовує стандарт ISO 639 для абревіатур мов та ISO 3166 для локалізацій. Якщо ваш переклад зроблено американською англійською, наприклад, ваше ім'я буде виглядати за типом en-US.po. Великі букви у разі теж важливі. Повний список мов та кодів країн є за посиланнями:

• Gettext коди мов
• Gettext коди країн

Як тільки ви зберігаєтеся, POEdit за замовчуванням автоматично створює .mo файл крім .po файлу. Рекомендується включати всі три файли на вашу тему, щоб люди могли створити свої переклади і легко редагувати існуючі.

Крок 4. Налаштування WordPress

Давайте підіб'ємо підсумок, що ви вже зробили. Ви сказали WordPress про весь текст, який ви хочете зробити доступним для перекладу, потім ви використовували POEdit для збору всіх рядків та поміщення їх у файл .горщик, який може бути переведений у файлах .po и .mo. Ці файли потім були включені до файлів теми.

Останній крок – це запакувати вашу тему, встановити її та дати WordPress зрозуміти, .mo файл якої мови ви хочете використати. Це дуже проста процедура, де ви звертаєтесь до файлу WP-config.php у кореневій папці вашого WordPress.

/**
 * WordPress Localized Language, defaults to English.
 *
 * Change this to localize WordPress. A corresponding MO file for the chosen
 * language must be installed to wp-content/languages. For example, install
 * de_DE.mo to wp-content/languages and set WPLANG to 'de_DE' to enable German
 * language support.
 */
define('WPLANG', '');

Ваш файл має вже містити define('WPLANG', ''); але якщо цього немає, ви можете додати. Вам просто потрібно додати свою мову та код локалізації в визначати. Якщо ви перекладали вашу тему російською, у вас буде наступне:

define('WPLANG', 'ru_RU');

Вашу роботу закінчено! Не забудьте додати ваш .горщик файл у вашу тему, і якщо ви можете перекласти вашу тему іншою мовою, включити також файли .po и .mo.

Джерело: WP.tutsplus.com

Олексій Шевченко

редактор wpcafe

Вивчає сайтобудування з 2008 року. Практикуючий вебмайстер, що спеціалізується на створенні сайтів WordPress. Задати питання Олексію можна на https://profiles.wordpress.org/wpthemeus/