FreeSource : AltLinux/Sisyphus/devel/SpecTips/MenuHowto

Эта страница была перенесена на altlinux.org. Текст на freesource.info заморожен.

1 Меню.


1.1 Оконные менеджеры, не поддерживающие freedesktop меню (viy: актуально [15.03.2008]).

ALT-специфичные функции install-menu:

encode_translate(locale, text, encoding) – возвращает переведенный
текст text для локали locale и перекодированный в кодировку encoding
encode(locale, text) – возвращает переведенный
текст text для локали locale и перекодированный в кодировку UTF-8
substr(text, npos, number) – возвращает подстроку из строки text
в количестве number символов, начиная с символа npos.
Минимальное значение npos – 0.

1.2 Приложения.

(viy: актуально для menu-методов оконных менеджеров, не поддерживающих freedesktop меню
Для приложений вместо создания меню файлов рекомендуется создание .desktop файлов. [15.03.2008]).

ALT-специфичные параметры в menu-файлах
(поддерживаются не всеми menu-методами):

extra_command – команда в стандарте freedesktop, например
extra_command="megaview %U"

extra_filename – не содержащее путь и расширение имя файла, в который
будет при необходимости сгенерирован пункт меню, например
extra_filename="megaview"

Если title="Mega View", то с параметром extra_filename в menu-методе
kde-* сгенерируется файл megaview.desktop, а без такого параметра -
mega_view.desktop или “Mega View.desktop”, что может привести
к некорректной работе некоторых программ.

extra_opt – дополнительные опции (специфичные только для desktop-файлов) для
корректной работы в средах, их поддерживающих, например
extra_opt="\\nDocPath=megaview/index.html\\nX-KDE-StartupNotify=true\\nX-DCOP-ServiceType=Multi"
extra_opt="\\nStartupNotify=true\\nX-GNOME-DocPath=panel/globalpanelprefs.html\\nX-GNOME-Bugzilla-Bugzilla=GNOME"

genericname – общее название/предназначение программы, например
genericname="Image Viewer"

longtitle – коментарий, краткое описание программы, например
longtitle="Very best graphical viewer with Open GL effects"

mimetypes – разделенный запятыми список типов MIME, с которыми должна
ассоциироваться данная программа из command, например
mimetypes="image/jpeg,image/x-xpm,image/x-xbm,image/x-bmp"

Файл в формате menu можно (но не нужно) получить конвертацией из desktop-файла
при помощи программы freedesktop2menu.pl из пакета menu-devel.

Пример:
freedesktop2menu.pl \
package_name \
"Applications / Monitoring" \
%buildroot/%_datadir/applications/SuperMonitor.desktop \
%buildroot/%_menudir/supermonitor \
environment

package_name – имя пакета. Если этот пакет не установлен,
то соответствующий пункт меню не генерируется.
environment – то, что попадет в значение needs menu-файла.
Если параметр пропущен, по умолчанию устанавливается needs="x11"
Может принимать следующие значения для оконных менеджеров – gnome, kde, icewm и др.
(cм. раздел supported в /etc/menu-methods/* для конкретного
оконного менеджера), а также служебные значения – x11, text, wm.
wm – указывается только в оконных менеджерах для использования в других
оконных менеджерах, из которых можно перезагружаться в первые
прямо из меню.
x11 – для любых графических программ в любых оконных менеджерах.
text – для текстовых программ. В графической среде автоматом запускаются
в терминале. Т.е. в параметре command не нужно указывать
эмулятор терминала.

Некоторые desktop-файлы, содержащие переводы на различные языки, можно
найти по адресу ftp://ftp.altlinux.ru/pub/people/zerg/menu/desktop-files

Рекомендуется наличие desktop-файлов в %_datadir/applications/
вместо menu-файлов. Это полезно для оконных менеджеров,
поддерживающих стандарт меню freedesktop.

1.3 Дополнительная информация.


Дополнительная информация находится в документации пакета menu.
Также описания дополнительных стандартов можно найти
на сайте http://freedesktop.org.