SpecTips/MenuHowto
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:
[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 OpenGL 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 \
- "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.