ICEWM-PROGRAMS(5)     Standards, Environments and Macros     ICEWM-PROGRAMS(5)


نام (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 را در بستهٔ توزیع ببینید.

icewm 4.1.0                       2026-08-06                 ICEWM-PROGRAMS(5)