Мови інтерфейсу

Energine 2.13 постачається з двома мовами — російською та українською; російська є стандартною, а українські сторінки розташовані за /ua/. Англійської немає. Мова додається в адмін-панелі: спочатку вона є копією стандартної, і ви перекладаєте її сторінки та рядки інтерфейсу.

1. Перед додаванням першої мови

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

DELETE t FROM share_lang_tags_translation t
LEFT JOIN share_lang_tags g ON g.ltag_id = t.ltag_id
WHERE g.ltag_id IS NULL;

2. Додавання мови

У «Редактор языков» (редактор мов), /admin/translations/languages/, або «Языки» (Мови) на панелі інструментів сторінки:

  1. Натисніть «Добавить» (Додати) і заповніть «Аббревиатура языка» (Абревіатура мови) — дві латинські літери, en — та «Название языка» (Назва мови) — English, не більше 20 символів. Збережіть.
  2. Виберіть мову, натисніть «Редактировать» (Редагувати) і вкажіть «Локаль» (Локаль), наприклад en_US.UTF8: у формі додавання поля локалі немає.
  3. «Поднять» (Вгору) та «Опустить» (Вниз) задають порядок мов у перемикачі.

Мова відразу відкривається з копією всього вмісту стандартної мови: сторінок, текстових блоків, новин, шаблонів листів та рядків інтерфейсу. /en/ показує сайт із російськими текстами, а адмін-панель за /en/admin/ має російські підписи — доки ви їх не перекладете. Щоб тимчасово виключити сторінку з певної мови, встановіть позначку «Отключен» (Вимкнено) на вкладці відповідної мови у формі сторінки: сторінка повертатиме 404 для цієї мови.

3. Переклад сторінок

Переключіть сайт на потрібну мову й редагуйте тексти в режимі редагування — у Firefox; дивіться Структура та контент. Назви, заголовки та описи знаходяться на вкладці відповідної мови у формі сторінки.

4. Переклад інтерфейсу

«Редактор переводов» (редактор перекладів), /admin/translations/, або «Переводы» (Переклади) на панелі інструментів сторінки, відображає кожну константу з «Перевод» (Переклад) на окремій вкладці для кожної мови. Назви місяців і днів тижня також є константами: TXT_MONTH_…, TXT_WEEKDAY_…. Кілька підписів записано безпосередньо в скриптах і відсутні в списку.

Консольні інструменти запускаються з htdocs/ від імені користувача сайту:

Команда Що робить
php index.php setup untranslated виводить список констант, які використовуються в коді та шаблонах, але не мають рядка в словнику
php index.php setup exportTrans записує константи, що використовуються в коді кожного модуля, до файлу install/translations.csv цього модуля — розділені ;, із заголовком CONST та абревіатурами мов; зупиняється на першому модулі без папки install/, тому створіть її в кожному модулі ядра — core/modules/<module>/install/, всередині репозиторію ядра — та в site/modules/main/
php index.php setup loadTransFile <file.csv> завантажує такий файл: додає константи, яких немає в словнику, і пропускає ті, що вже є

loadTransFile не може змінити рядки, які нова мова отримала як копії: перекладайте їх у редакторі перекладів або безпосередньо в таблиці share_lang_tags_translation бази даних.

Видалення мови

Поточну та стандартну мову видалити не можна. Видалення іншої мови видаляє весь збережений у ній контент; дивіться Відомі ризики.