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

Страницы и строки интерфейса переводятся. Установщик добавляет английский, русский и украинский языки; русский используется по умолчанию.

Языки

У языка по умолчанию в адресах нет префикса; у другого языка его аббревиатура служит первой частью пути: /ua/about/. Для украинского языка используется ua в адресах и uk в атрибуте lang страниц.

«Редактор языков» (Language editor) — /admin/translations/languages/ и кнопка «Языки» (Languages) на панели инструментов панели управления — позволяет добавлять, редактировать, упорядочивать и удалять языки:

  • для нового языка требуются «Аббревиатура языка» (две строчные латинские буквы), «Название языка» (Language name) и «Открыт посетителям» (Open to visitors);
  • форма редактирования также задает «Язык по умолчанию» (Default language) и локаль;
  • текущий язык и язык по умолчанию удалить нельзя.

Новый язык создается как копия языка по умолчанию: из него копируются все названия страниц, тексты, строки интерфейса и почтовые шаблоны, готовые к переводу.

Язык в подготовке. Снимите отметку «Открыт посетителям»: посетители будут получать 404 по его адресам и не увидят его в переключателе языков, тогда как редакторы — пользователи, чья группа имеет полные права на главную страницу, — увидят его с пометкой «(в подготовке)» (in preparation). Язык по умолчанию закрыть нельзя.

Переключатель языков входит в макет «Базовый» (Basic) и отображается, когда открыто более одного языка.

Перевод страниц

Название страницы, заголовок (title), описание (description), ключевые слова (keywords) и отметка «Отключен» (Disabled) задаются для каждого языка на языковых вкладках формы страницы; страница, отключенная на каком-то языке, отвечает на нем ошибкой 404. Тексты переводятся на самой странице: переключите сайт на этот язык и редактируйте, включив «Режим редактирования» (Edit mode). Очистка текста на одном языке оставляет остальные без изменений.

Строки интерфейса

Каждая подпись на сайте и в панели управления — это строка интерфейса: константа вида TXT_SITE_NAME с переводом для каждого языка. Для строки без перевода выводится имя константы.

  • «Редактор переводов» (Translations editor) — /admin/translations/ и кнопка «Переводы» (Translations) на панели инструментов панели управления — позволяет редактировать их для каждого языка.
  • Собственные строки сайта находятся в site/modules/main/translations.php: 'CONST' => ['ru' => '…', 'ua' => '…']. Команда php index.php setup translations добавляет недостающие строки в базу данных и никогда не перезаписывает перевод, отредактированный в панели управления; параметр --file=PATH считывает другой файл.
  • php index.php setup untranslated выводит список строк, используемых в коде и шаблонах, для которых нет перевода; setup check сообщает о них как об ошибке.

Справка ? окна панели управления — это строка HELP_<CLASS>_<STATE>, поэтому она переводится и редактируется точно так же, как и любая другая.