- Главная
- Документация
- Языки интерфейса
Языки интерфейса
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 базы данных.
Удаление языка
Текущий язык и язык по умолчанию удалить невозможно. При удалении другого языка удаляется всё хранимое в нём содержимое; см. Известные риски.