icewm-menu(5)

ИМЯ

 icewm-menu - конфигурационный файл меню icewm

СИНОПСИС

 $ICEWM_PRIVCFG/menu
 $XDG_CONFIG_HOME/icewm/menu
 $HOME/.icewm/menu
 /etc/X11/icewm/menu
 /usr/share/X11/icewm/menu

ОПИСАНИЕ

Файл menu отвечает за максимальную настройку корневого (стартового) меню icewm(1).

Меню приложений обычно настраивается пользователем. icewm предоставляет программу icewm-menu-fdo(1), чтобы сгенерировать меню по умолчанию. Похожими программами являются xdg_menu(1), mmaker(1) (MenuMaker), xde-menu(1), xdgmenumaker(1).

ФОРМАТ

Форматом файла предусмотрен следующий синтаксис строк:

prog ["]title["] icon program options

Определяет программу, выполняемую при выборе пункта меню.

restart ["]title["] icon program options

Определяет программу, замещающую диспетчер окон при выборе пункта меню. Это предназначено для запуска других диспетчеров окон изнутри icewm(1).

runonce ["]title["] icon "[res_name][.res_class]" program options

Определяет программу, выполняемую при выборе пункта меню; однако, если окно с определёнными res_name и res_class уже имеется, программа не будет выполнена снова.

menu ["]title["] icon { # contained items }

Определяет вложенное меню. Строки, которые находятся между фигурными скобками, могут быть любыми пунктами меню, описанными здесь.

menufile ["]title["] icon ["]filename["]

Определяет файл, с которым собирать пункты (строки) вложенного меню и располагать их на этом месте в меню.

menuprog ["]title["] icon program options

Определяет программу, которая напечатает пункты вложенного меню на стандартный вывод и соберёт и разместит во вложенном меню в этом месте.

menuprogreload ["]title["] icon timeout program options

Похоже на menuprog, но после истечения timeout секунд меню будет перегенерировано.

include ["]filename["]

Считывать дополнительные записи из файла filename.

includeprog program options

Считывать дополнительные записи из вывода program options.

separator

Разделитель пунктов меню.

Где

prog, restart, runonce, menu, menufile, menuprog, menuprogreload, include, includeprog, separator

Эти ключевые слова являются символьными строками.

["]title["]

Это строка title, связанная с пунктом меню, которая показывается в меню. Когда title содержит пробелы, заголовок должен быть окружён двойными кавычками (""").

icon

Имя файла значка (с или без расширения) или полный путь к файлу значка.

"[res_name][.res_class]"

res_name имя ресурса окна, запущенного program и res_class класс ресурса окна. Необходимо определить только один из res_name или res_class. Это используется, чтобы идентифицировать, повторно ли запущена программа и нужно для использования с ключевым словом runonce.

program options

program является именем исполняемого файла или полным путём к исполняемому файлу, который будет запущен в ответ на выбор пункта меню. При использовании с ключевым словом menuprog, program должна напечатать на стандартный вывод содержимое меню и используется для динамических меню.

options являются параметрами и аргументами, которые дословно передаются program.

filename

filename является именем файла относительно одного из каталогов конфигурации icewm(1), или полным путём к файлу. Файл используется с ключевым словом menufile и определяет файл, из которого считываются последующие пункты меню.

ПРИМЕРЫ

Следующий пример файла menu поставляется с icewm(1).

 # This is an example for IceWM's menu definition file.
 #
 # Place your variants in /etc/X11/icewm or in $HOME/.icewm
 # since modifications to this file will be discarded when you
 # (re)install icewm.
 #
 prog xterm xterm xterm
 prog rxvt xterm rxvt -bg black -cr green -fg white -C -fn 9x15 -sl 500
 prog fte fte fte
 prog NEdit nedit nedit
 prog Mozilla mozilla mozilla
 prog XChat xchat xchat
 prog Gimp gimp gimp
 separator
 menuprog "Desktop Apps" folder icewm-menu-fdo
 menufile Programs folder programs
 menufile Tool_bar folder toolbar

ФАЙЛЫ

Местоположениями для файла menu являются следующие:

 $ICEWM_PRIVCFG/menu
 $XDG_CONFIG_HOME/icewm/menu
 $HOME/.icewm/menu
 /etc/X11/icewm/menu
 /usr/share/X11/icewm/menu

Местоположения обследуются в указанном порядке; первый найденный файл прочитывается, а остальные игнорируются.

СМ. ТАКЖЕ

icewm(1), icewm-menu-fdo(1).

АВТОР

Brian Bidulock <mailto:bidulock@openss7.org>.

Перевод данного текста на русский язык, а также поддержка пакета программного обеспечения icewm в ALTLinux Dmitriy Khanzhin <mailto:jinn@altlinux.org>.

ЛИЦЕНЗИЯ

IceWM лицензирован под GNU Library General Public License. См. файл COPYING в комплекте поставки.