نام (NAME)

icewm-menu - فایل پیکربندی منوی icewm

خلاصه دستور (SYNOPSIS)

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

توضیحات (DESCRIPTION)

پروندهٔ menu مسئول پیکربندی بخش عمده‌ای از منوی ریشه (root menu) و منوی شروع icewm(1) است.

منویی که دسترسی به برنامه‌ها را فراهم می‌کند؛ معمولاً توسط کاربر سفارشی‌سازی می‌شود. برنامهٔ icewm-menu-fdo(1) یک منوی پیش‌فرض تولید می‌کند که شامل بیشتر برنامه‌های رومیزی سیستم است. برنامه‌های مشابه عبارتند از xdg_menu(1)، mmaker(1)، xde-menu(1) و xdgmenumaker(1).

قالب (FORMAT)

این فایل شامل خطوطی با نحو زیر است:

prog "title" icon program options: برنامه‌ای را مشخص می‌کند که هنگام انتخاب آیتم منو اجرا شود.
restart "title" icon program options: برنامه‌ای را مشخص می‌کند که هنگام انتخاب آیتم منو، جایگزین مدیر پنجره شود. این گزینه برای راه‌اندازی سایر مدیرهای پنجره از داخل icewm(1) کاربرد دارد.
runonce "title" icon "[name][.class]" program options: برنامه‌ای را مشخص می‌کند که هنگام انتخاب آیتم منو اجرا شود؛ اما اگر پنجره‌ای با name و 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: این‌ها کلیدواژه‌های رشته‌ای صریح (literal) هستند.
"title": رشتهٔ title مرتبط با آیتم منو است که در منو نمایش داده می‌شود. هنگامی که title شامل فاصله باشد، عنوان باید درون علامت نقل‌قول دوتایی ("") قرار گیرد.
icon: نام فایل آیکون (با یا بدون پسوند) یا مسیر کامل به یک فایل آیکون است.
"[name][.class]": name نام منبع پنجره‌ای است که توسط program اجرا شده و class کلاس منبع پنجره است. تنها مشخص کردن یکی از name یا class کافی است. این مقدار برای تشخیص اینکه آیا برنامه از قبل در حال اجرا است یا خیر استفاده می‌شود و همراه با کلیدواژهٔ runonce به کار می‌رود.
program options: program نام فایل اجرایی یا مسیر کامل به فایل اجرایی است که در پاسخ به انتخاب آیتم منو اجرا خواهد شد. هنگامی که با کلیدواژهٔ menuprog استفاده می‌شود، program باید محتوای منو را در خروجی استاندارد چاپ کند که برای منوهای پویا استفاده می‌شود.
options گزینه‌ها و آرگومان‌هایی است که عیناً به program فرستاده می‌شوند.
filename: filename نام فایل به‌صورت نسبی نسبت به یکی از دایرکتوری‌های پیکربندی icewm(1) یا مسیر کامل به یک فایل است. این فایل با کلیدواژهٔ menufile استفاده می‌شود و فایلی را مشخص می‌کند که آیتم‌های بیشتر منو از آن خوانده شوند.

مثال‌ها (EXAMPLES)

در ادامه یک نمونه فایل menu که همراه با icewm(1) ارائه می‌شود آمده است:

# This is an example for IceWM's menu definition file.
#
# Place your variants in /usr/etc/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

فایل‌ها (FILES)

مکان‌های فایل menu به شرح زیر است:

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

مکان‌ها به ترتیبی که فهرست شده‌اند جستجو می‌شوند؛ اولین فایل یافت‌شده خوانده می‌شود و از بقیه صرف‌نظر خواهد شد.

همچنین ببینید (SEE ALSO)

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

نویسندگان (AUTHORS)

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

مجوز (LICENSE)

IceWM تحت «مجوز عمومی همگانی کتابخانه گنو» (GNU Library General Public License) منتشر شده است. فایل COPYING را در بستهٔ توزیع ببینید.