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