Центр управления и его модули.
Центр управления – это прежде всего способ объединить разрозненные модули alterator.
Каждый модуль содержит некоторое описание, на основании которого вычисляется его имя и местоположение внутри
двухуровневого меню. Это описание имеет традиционный формат desktop-файла и располагается в каталоге /usr/share/alterator/applications.
Модули объединяются в группы (первый уровень меню), каждая группа имеет описание в виде directory-файла и располагается в каталоге /usr/share/alterator/desktop-directories. Группы связаны с модулями косвенно через так называемые категории.
Группа модулей
В файле описания группы модулей используются следующие параметры:
- Name – имя группы. Также возможна запись локализованных имён в параметрах Name[locale], где locale – полное имя локали (например ru_RU)
- Icon – картинка для группы, пока не используется
- Type – всегда равно directory
- Encoding – всегда равно UTF-8
- X-Alterator-Category – имя категории, которую представляет данная группа.
- X-Alterator-Weight – вес группы. В меню группы сортируются согласно их весу.
Пример описания группы:
Модули
В файле описания модуля используются следующие параметры:
- Name – имя группы. Также возможна запись локализованных имён в параметрах Name[locale], где locale – полное имя локали (например ru_RU).
- Icon – картинка для модуля, пока не используется
- Categories – категории, с которыми связан данный модуль (пока допустимо перечислять только одну категорию)
- Type – всегда равно application
- Encoding – всегда равно UTF-8
- Terminal – всегда равно false.
- X-Alterator-URI – местоположение модуля (трактовка несколько отличается в acc и в fbi)
- X-Alterator-Help – название справки. Справка пишется в формате html и размещается по адресу /usr/share/alterator/help/locale/name.html, где locale – полное имя локали, а name – имя, указанное в данном параметре.
- X-Alterator-Weight – вес модуля. Внутри группы, элементы сортируются согласно их весу.
Пример описания модуля:
Обновление старых модулей FBI
В старом alterator-fbi описание модуля размещалось внутри template-* бакенда. Соответственно для перехода на новую систему необходимо:
- Убрать ответ на запрос info.
- Убрать из ответа на запрос template параметр help.
Современный alterator-fbi поддерживает оба способа описания местоположения файла со справкой.
Заключительное замечание
Сейчас используется единый бакенд для вычисления имени справки для acc, fbi и wizardface.
Для обратной совместимости поиск файлов с документацией производится по нескольким каталогам в следующем порядке:
- /usr/share/alterator/help ( основной каталог)
- /usr/share/install2/help ( каталог ранее использовавшийся в alterator-wizardface)
- /var/www/html/fbi/help ( каталог ранее использовавшийся в alterator-fbi)
Будьте внимательны и старайтесь чтобы имена не пересекались и не перекрывались.