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


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

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