نام (NAME)

icewm-programs - فایل پیکربندی برنامه‌های icewm

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

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

توضیحات (DESCRIPTION)

فایل programs یک فایل پیکربندی فهرست (منو) برنامه‌های نصب‌شده است که به‌طور خودکار تولید می‌شود. این فایل باید توسط xdg_menu، wmconfig (ردهت)، menu (دبیان) یا icewm-menu-fdo، احتمالاً به عنوان بخشی از توالی ورود به سیستم یا راه‌اندازی X تولید شود.

ساختار (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)

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

# This file is intended to be customized by the distributions.
# (they should place it in /etc/X11/icewm)
#
# mostly obsolete, fixme
menu Editors folder {
    prog vim vim gvim
    prog emacs emacs emacs
    prog Lyx emacs lyx
}
menu "WWW" folder {
    prog Galeon galeon galeon
    prog Arena arena arena
    prog Lynx lynx xterm -e lynx
    prog Links lynx xterm -e links
}
menu "Document Viewers" folder {
    prog "DVI Previewer" xdvi xdvi
    prog "Ghostview" ghostview gv
}
menu Graphics folder {
    prog Gimp gimp gimp
    prog XV xv xv
    prog XPaint xpaint xpaint
    prog XFig xfig xfig
}
menu Games folder {
    prog Xboard xboard xboard
    prog "Tux Racer" tuxracer tuxracer
}
menu System folder {
    prog "Control Panel" redhat control-panel
}
menu Utilities folder {
    prog XPlayCD xplaycd xplaycd
    prog XMixer xmixer xmixer
    prog Clock xclock xclock
    prog Magnify xmag xmag
    prog Calculator xcalc xcalc
    prog Colormap xcolormap xcmap
    prog Clipboard xclipboard xclipboard
    prog xkill bomb xkill
    prog xload xload xload
    prog xosview xosview xosview
    separator
    prog "Screen Saver" xlock xlock -nolock
    prog "Screen Lock" xlock xlock
}
menu "Window Managers" folder {
    restart icewm - icewm
    restart metacity - metacity
    restart wmaker - wmaker
    restart fluxbox - fluxbox
    restart blackbox - blackbox
    restart enlightenment - enlightenment
    restart fvwm2 - fvwm2
    restart fvwm - fvwm
    restart sawfish - sawfish
    restart sawfish2 - sawfish2
}

فایل‌ها (FILES)

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

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

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

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

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

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

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

مجوز (LICENSE)

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