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

Центр управления – это прежде всего способ объединить разрозненные модули alterator.
Каждый модуль содержит некоторое описание, на основании которого вычисляется его имя и местоположение внутри
двухуровневого меню. Это описание имеет традиционный формат desktop-файла и располагается в каталоге /usr/share/alterator/applications.
Модули объединяются в группы (первый уровень меню), каждая группа имеет описание в виде directory-файла и располагается в каталоге /usr/share/alterator/desktop-directories. Группы связаны с модулями косвенно через так называемые категории.

Группа модулей

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

• Name – имя группы. Также возможна запись локализованных имён в параметрах Name[locale], где locale – имя локали (например ru). Для локализованных имён должна использоваться кодировка UTF-8.
• Icon – картинка для группы, пока не используется
• Type – всегда равно directory
• X-Alterator-Category – имя категории, которую представляет данная группа.
• X-Alterator-Weight – вес группы. В меню группы сортируются согласно их весу.

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

Модули

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

• Name – имя группы. Также возможна запись локализованных имён в параметрах Name[locale], где locale – имя локали (например ru). Для локализованных имён должна использоваться кодировка UTF-8.
• Icon – картинка для модуля, пока не используется
• Categories – категории, с которыми связан данный модуль (пока допустимо перечислять только одну категорию)
• Type – всегда равно application
• 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] Type=Application Categories=X-Alterator-System Icon=control Terminal=false Name=System objects Name[ru]=Системные объекты Name[uk]=Системні об'єкти X-Alterator-URI=/control X-Alterator-Weight=10 X-Alterator-Help=control

Замечание про разные интерфейсы.

Система меню и справки едина и для GUI и HTML интерфейса, однако до сих пор ещё встречаются модули, которые работают только в одном типе интерфейса. Для того чтобы они не появлялись в меню того центра управления, где они не работают, существует параметр X-Alterator-UI, позволяющий ограничить доступные интерфейсы. Допустимые значения данного параметра “html” и “qt” .

В будущем, при окончательном переходе с устаревшей системы с template-*, данный параметр потеряет смысл, поскольку оценку возможностей модуля можно будет производить автоматически.