Языки интерфейса

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 базы данных.

Удаление языка

Текущий язык и язык по умолчанию удалить невозможно. При удалении другого языка удаляется всё хранимое в нём содержимое; см. Известные риски.