FreeSource: Free Source (Версия для печати)

Центр управления и его модули.

Центр управления – это прежде всего способ объединить разрозненные модули 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 – вес группы. В меню группы сортируются согласно их весу.

Пример описания группы:
[Desktop Entry] Encoding=UTF-8 Type=Directory Name=Statistics Name[ru_RU]=Статистика Icon=system X-Alterator-Category=X-Alterator-Statistics X-Alterator-Weight=15

Модули

В файле описания модуля используются следующие параметры:

• 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 – вес модуля. Внутри группы, элементы сортируются согласно их весу.

Пример описания модуля:

[Desktop Entry] Encoding=UTF-8 Type=Application Categories=X-Alterator-System Icon=control Terminal=false Name=System objects Name[ru_RU]=Системные объекты Name[uk_UA]=Системні об'єкти X-Alterator-URI=/control X-Alterator-Weight=10 X-Alterator-Help=control

Обновление старых модулей FBI

В старом alterator-fbi описание модуля размещалось внутри template-* бакенда. Соответственно для перехода на новую систему необходимо:

1. Убрать ответ на запрос info.
2. Убрать из ответа на запрос template параметр help.

Современный alterator-fbi поддерживает оба способа описания местоположения файла со справкой.

Заключительное замечание

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

• /usr/share/alterator/help ( основной каталог)
• /usr/share/install2/help ( каталог ранее использовавшийся в alterator-wizardface)
• /var/www/html/fbi/help ( каталог ранее использовавшийся в alterator-fbi)

Будьте внимательны и старайтесь чтобы имена не пересекались и не перекрывались.