Babel

Что такое Babel?

Babel – это дополнение для MODx Revolution, которое призвано помочь в управлении Вашими мультиязычными веб-сайтами с использованием различных контекстов. Babel поддерживает даже управление несколькими мультиязычными веб-сайтами в одном образце MODx с помощью так называемых контекстных групп.

▶ Babel сохраняет ссылки между переведенными ресурсами. В менеджере Вы можете использовать Babel Box, чтобы легко переключаться между различными языковыми версиями Ваших ресурсов. Переведенные версии Babel могут создаваться автоматически или задаваться вручную.

Кроме того, Babel может использоваться для синхронизации определенных шаблонных переменных (template variables, TV) переведенных ресурсов, которые должны быть аналогичными в любом контексте (языке).

История

Babel разработал Якоб Класс (Jakob Class) на основе идей Sylvain Aerni, впервые приложение было выпущено 16 декабря 2010 года.

Установка

Подготовка

Создайте контекст под каждый из языков и задайте настройки cultureKey и site_url в соответствии со своими потребностями.

Убедитесь, что переключения контекстов происходят корректно.

Скачивание

Babel можно скачать с помощью менеджера в MODx Revolution через Package Management, или через MODx Extras Repository/

Установка

Установите Babel с помощью пакет-менеджера и задайте системные настройки Babel, используя форму, которая отображается во время установки:

<code><strong>Context</strong><strong>Keys</strong> (babel.contextKeys): список контекстных клавиш через запятую, которые применяются для связки мультиязычных ресурсов.<br />

В расширенной конфигурации Вы можете определить несколько групп контекстных клавиш с помощью точки с запятой (;) в качестве разделителя. Это пригодится для администрирования нескольких многоязычных сайтов в одном образце MODx.

Пример:

ёsite1: en, de, fr. c контекстами web, site1de, site1fr<

site2: en, de. с контекстами site2en, site2de

Вы выбираете babel.contextKeys для " web,site1de,site1fr;site2en,site2de".

• Имя Babel TV (babel.babelTvName): Имя шаблонной переменной (TV), в которой Babel будет хранить ссылки между мультиязычными ресурсами. Эту TV будет поддерживать Babel. Пожалуйста, не изменяйте TV в ручном режиме, иначе Ваши ссылки между переведенными версиями могут быть утрачены.

• ID шаблонных переменных должны быть синхронизированы (babel. syncTvs): разделенный запятыми список идентификаторов шаблонных переменных (TV), которые Babel должен синхронизировать.

Как пользоваться

При открытии ресурса для редактирования Babel Box будет отображаться в верхней части формы ресурса. Там же находятся ссылки в виде кнопок для каждого из языков (контекстов), заданных в настройках системы babel.contextKeys.

Три различных цвета, в которых могут отображаться кнопки, означают:

• Черный: язык ресурса, отображающегося в данный момент.

• Зеленый: язык, для которого определена переведенная версия ресурса.

• Светло-серый: язык, для которого переведенная версия пока не была создана или определена.

Нажимая на (зеленые) кнопки языков, Вы можете легко переключаться между различными языковыми версиями Ваших ресурсов.

Если перевод не определен для данного языка (серая кнопка), наведите курсор мыши на языковую кнопку – появляется окно, в котором можно задать Babel создать перевод текущего ресурса, или вставить ссылку перевода на существующий ресурс вручную, для чего требуется ввести ID переведенного ресурса.

Кликая на "Create Translation", Вы задаете Babel создать новый ресурс в контексте языка и скопировать все содержимое текущего ресурса для вновь созданного. Далее Вы можете перевести вест контент, TV и опубликовать переведенный ресурс.
Если Вы хотите удалить ссылку на переведенную версию, просто наведите курсор мыши на зеленую кнопку языка: появляется окно с опцией "Unlink translation" для ее удаления.

Сниппеты

В настоящее время два сниппета доступны для Babel: BabelLinks и BabelTranslation.

Изменение настроек Babel после установки

Вы можете изменить настройки Babel после установки. Например, если Вы хотите определить новую TV, которая должна быть синхронизирована, или добавить новый контекст. Для этого перейдите в System/Settings в менеджере MODx и выберите местоположение babel. Теперь Вы можете редактировать все параметры Babel:

BabelLinks

BabelLinks – это snippet, который отображает ссылки на другие языки (контексты) для конечного пользователя.

Доступные параметры

BabelLink Chunk

Если параметр &tpl не установлен, по умолчанию Chunk будет использоваться со следующим кодом:

<li><a href="" class="">babel.language_</a></li>

Используя собственный блок для отображения языковых ссылок, Вы можете использовать следующие идентификаторы (placeholders):

Пример

[[BabelLinks]]

BabelTranslation

Snippet BabelTranslation возвращают ID переведенных ресурсов в данном контексте.

Доступные параметры

Пример

Чтобы вернуть ID переведенного ресурса, который находится в "de" контексте текущего ресурса.