- Головна
- Документація
- Мови інтерфейсу
Мови інтерфейсу
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/, або «Языки» (Мови) на панелі інструментів сторінки:
- Натисніть «Добавить» (Додати) і заповніть «Аббревиатура языка» (Абревіатура мови) — дві латинські літери,
en— та «Название языка» (Назва мови) —English, не більше 20 символів. Збережіть. - Виберіть мову, натисніть «Редактировать» (Редагувати) і вкажіть «Локаль» (Локаль), наприклад
en_US.UTF8: у формі додавання поля локалі немає. - «Поднять» (Вгору) та «Опустить» (Вниз) задають порядок мов у перемикачі.
Мова відразу відкривається з копією всього вмісту стандартної мови: сторінок, текстових блоків, новин, шаблонів листів та рядків інтерфейсу. /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 бази даних.
Видалення мови
Поточну та стандартну мову видалити не можна. Видалення іншої мови видаляє весь збережений у ній контент; дивіться Відомі ризики.