.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "ICEWM-MENU 5" .TH ICEWM-MENU 5 2026-08-06 "icewm\ 4.1.0" "Standards, Environments and Macros" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" .IX Subsection "NAME" icewm\-menu \- فایل پیکربندی منوی icewm .SH "خلاصه دستور (SYNOPSIS)" .IX Subsection "SYNOPSIS" .Vb 5 \& $ICEWM_PRIVCFG/menu \& $XDG_CONFIG_HOME/icewm/menu \& $HOME/.icewm/menu \& /usr/etc/icewm/menu \& /usr/share/icewm/menu .Ve .SH "توضیحات (DESCRIPTION)" .IX Subsection "DESCRIPTION" پروندهٔ \fImenu\fR مسئول پیکربندی بخش عمده‌ای از منوی ریشه (root menu) و منوی شروع \fBicewm\fR\|(1) است. .PP منویی که دسترسی به برنامه‌ها را فراهم می‌کند؛ معمولاً توسط کاربر سفارشی‌سازی می‌شود. برنامهٔ \fBicewm\-menu\-fdo\fR\|(1) یک منوی پیش‌فرض تولید می‌کند که شامل بیشتر برنامه‌های رومیزی سیستم است. برنامه‌های مشابه عبارتند از \fBxdg_menu\fR\|(1)، \fBmmaker\fR\|(1)، \&\fBxde\-menu\fR\|(1) و \fBxdgmenumaker\fR\|(1). .SH "قالب (FORMAT)" .IX Subsection "FORMAT" این فایل شامل خطوطی با نحو زیر است: .IP "\fBprog\fR \fB""\fR\fItitle\fR\fB""\fR \fIicon\fR \fIprogram\fR \fIoptions\fR" 4 .IX Item "prog ""title"" icon program options" برنامه‌ای را مشخص می‌کند که هنگام انتخاب آیتم منو اجرا شود. .IP "\fBrestart\fR \fB""\fR\fItitle\fR\fB""\fR \fIicon\fR \fIprogram\fR \fIoptions\fR" 4 .IX Item "restart ""title"" icon program options" برنامه‌ای را مشخص می‌کند که هنگام انتخاب آیتم منو، جایگزین مدیر پنجره شود. این گزینه برای راه‌اندازی سایر مدیرهای پنجره از داخل \&\fBicewm\fR\|(1) کاربرد دارد. .IP "\fBrunonce\fR \fB""\fR\fItitle\fR\fB""\fR \fIicon\fR \fB""\fR[\fIname\fR][\fB.\fR\fIclass\fR]\fB""\fR \fIprogram\fR \fIoptions\fR" 4 .IX Item "runonce ""title"" icon ""[name][.class]"" program options" برنامه‌ای را مشخص می‌کند که هنگام انتخاب آیتم منو اجرا شود؛ اما اگر پنجره‌ای با \fIname\fR و \fIclass\fR مشخص‌شده وجود داشته باشد، برنامه دوباره اجرا نخواهد شد. .IP "\fBmenu\fR \fB""\fR\fItitle\fR\fB""\fR \fIicon\fR \fB{\fR # contained items \fB}\fR" 4 .IX Item "menu ""title"" icon { # contained items }" یک زیرمنو را مشخص می‌کند. خطوطی که بین آکولادها قرار می‌گیرند می‌توانند هر یک از آیتم‌های منوی شرح‌داده‌شده در اینجا باشند. .IP "\fBmenufile\fR \fB""\fR\fItitle\fR\fB""\fR \fIicon\fR \fB""\fR\fIfilename\fR\fB""\fR" 4 .IX Item "menufile ""title"" icon ""filename""" فایلی را مشخص می‌کند که آیتم‌های (خطوط) زیرمنو از آن جمع‌آوری شده و در این نقطه از منو قرار گیرند. .IP "\fBmenuprog\fR \fB""\fR\fItitle\fR\fB""\fR \fIicon\fR \fIprogram\fR \fIoptions\fR" 4 .IX Item "menuprog ""title"" icon program options" برنامه‌ای را مشخص می‌کند که آیتم‌های زیرمنو را در خروجی استاندارد چاپ می‌کند، که سپس جمع‌آوری شده و در این نقطه در زیرمنو قرار می‌گیرند. .IP "\fBmenuprogreload\fR \fB""\fR\fItitle\fR\fB""\fR \fIicon\fR \fItimeout\fR \fIprogram\fR \fIoptions\fR" 4 .IX Item "menuprogreload ""title"" icon timeout program options" مشابه \fBmenuprog\fR است، اما پس از گذشت دست‌کم \fItimeout\fR ثانیه، منو مجدداً بازتولید می‌شود. .IP "\fBinclude\fR \fB""\fR\fIfilename\fR\fB""\fR" 4 .IX Item "include ""filename""" مدخل‌های اضافی را از فایل \fIfilename\fR می‌خواند. .IP "\fBincludeprog\fR \fIprogram\fR \fIoptions\fR" 4 .IX Item "includeprog program options" مدخل‌های اضافی را از خروجی \fIprogram\fR \fIoptions\fR می‌خواند. .IP \fBseparator\fR 4 .IX Item "separator" یک جداکننده برای آیتم‌های منو. .PP به‌طوری که: .IP "\fBprog\fR, \fBrestart\fR, \fBrunonce\fR, \fBmenu\fR, \fBmenufile\fR, \fBmenuprog\fR, \fBmenuprogreload\fR, \fBinclude\fR, \fBincludeprog\fR, \fBseparator\fR" 4 .IX Item "prog, restart, runonce, menu, menufile, menuprog, menuprogreload, include, includeprog, separator" این‌ها کلیدواژه‌های رشته‌ای صریح (literal) هستند. .IP "\fB""\fR\fItitle\fR\fB""\fR" 4 .IX Item """title""" رشتهٔ \fItitle\fR مرتبط با آیتم منو است که در منو نمایش داده می‌شود. هنگامی که \fItitle\fR شامل فاصله باشد، عنوان باید درون علامت نقل‌قول دوتایی (\f(CW\*(C`\*(C'\fR) قرار گیرد. .IP \fIicon\fR 4 .IX Item "icon" نام فایل آیکون (با یا بدون پسوند) یا مسیر کامل به یک فایل آیکون است. .IP "\fB""\fR[\fIname\fR][\fB.\fR\fIclass\fR]\fB""\fR" 4 .IX Item """[name][.class]""" \&\fIname\fR نام منبع پنجره‌ای است که توسط \fIprogram\fR اجرا شده و \fIclass\fR کلاس منبع پنجره است. تنها مشخص کردن یکی از \fIname\fR یا \fIclass\fR کافی است. این مقدار برای تشخیص اینکه آیا برنامه از قبل در حال اجرا است یا خیر استفاده می‌شود و همراه با کلیدواژهٔ \fBrunonce\fR به کار می‌رود. .IP "\fIprogram\fR \fIoptions\fR" 4 .IX Item "program options" \&\fIprogram\fR نام فایل اجرایی یا مسیر کامل به فایل اجرایی است که در پاسخ به انتخاب آیتم منو اجرا خواهد شد. هنگامی که با کلیدواژهٔ \fBmenuprog\fR استفاده می‌شود، \fIprogram\fR باید محتوای منو را در خروجی استاندارد چاپ کند که برای منوهای پویا استفاده می‌شود. .Sp \&\fIoptions\fR گزینه‌ها و آرگومان‌هایی است که عیناً به \fIprogram\fR فرستاده می‌شوند. .IP \fIfilename\fR 4 .IX Item "filename" \&\fIfilename\fR نام فایل به‌صورت نسبی نسبت به یکی از دایرکتوری‌های پیکربندی \fBicewm\fR\|(1) یا مسیر کامل به یک فایل است. این فایل با کلیدواژهٔ \fBmenufile\fR استفاده می‌شود و فایلی را مشخص می‌کند که آیتم‌های بیشتر منو از آن خوانده شوند. .SH "مثال‌ها (EXAMPLES)" .IX Subsection "EXAMPLES" در ادامه یک نمونه فایل \fImenu\fR که همراه با \fBicewm\fR\|(1) ارائه می‌شود آمده است: .PP .Vb 10 \& # This is an example for IceWM\*(Aqs 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 .Ve .SH "فایل‌ها (FILES)" .IX Subsection "FILES" مکان‌های فایل \fImenu\fR به شرح زیر است: .PP .Vb 5 \& $ICEWM_PRIVCFG/menu \& $XDG_CONFIG_HOME/icewm/menu \& $HOME/.icewm/menu \& /usr/etc/icewm/menu \& /usr/share/icewm/menu .Ve .PP مکان‌ها به ترتیبی که فهرست شده‌اند جستجو می‌شوند؛ اولین فایل یافت‌شده خوانده می‌شود و از بقیه صرف‌نظر خواهد شد. .SH "همچنین ببینید (SEE ALSO)" .IX Subsection "SEE ALSO" \&\fBicewm\fR\|(1), \&\fBicewm\-menu\-fdo\fR\|(1). .SH "نویسندگان (AUTHORS)" .IX Subsection "AUTHOR" Brian Bidulock . .SH "مجوز (LICENSE)" .IX Subsection "LICENSE" \&\fBIceWM\fR تحت «مجوز عمومی همگانی کتابخانه گنو» (GNU Library General Public License) منتشر شده است. فایل \fICOPYING\fR را در بستهٔ توزیع ببینید.