.\" -*- 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-FDO 1" .TH ICEWM-MENU-FDO 1 2026-08-06 "icewm\ 4.1.0" "User Commands" .\" 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\-fdo \- تولید منوی برنامه‌های سازگار با FreeDesktop.org برای IceWM .SH "خلاصه دستور (SYNOPSIS)" .IX Subsection "SYNOPSIS" \&\fBicewm\-menu\-fdo\fR [\fIگزینه‌ها\fR] [\fIنام_پرونده\fR] .SH "توضیحات (DESCRIPTION)" .IX Subsection "DESCRIPTION" \&\fBicewm\-menu\-fdo\fR یک منو برای مدیر پنجره \fBIceWM\fR از توصیف‌کننده‌های منوی XDG (معروف به پرونده‌های \fI.desktop\fR در FreeDesktop.Org) تولید می‌کند. با گنجاندن این مورد در \fBicewm\-menu\fR\|(1)، برنامه‌های کاربردی سیستم در منوی شروع icewm در دسترس قرار می‌گیرند. .SH "آرگومان‌ها (ARGUMENTS)" .IX Subsection "ARGUMENTS" .IP [\fIنام_پرونده\fR] 4 .IX Item "[FILENAME]" آرگومان اختیاری \fIنام_پرونده\fR مسیر یک پرونده \fI.desktop\fR است. در صورت ارائه، \fBicewm\-menu\-fdo\fR برنامه را با استفاده از خط \f(CW\*(C`Exec\*(C'\fR از پرونده دسکتاپ اجرا می‌کند. .SH "گزینه‌ها (OPTIONS)" .IX Subsection "OPTIONS" .IP "\fB\-g\fR, \fB\-\-generic\fR" 4 .IX Item "-g, --generic" گنجاندن نام عمومی در پرانتز در عنوان ورودی‌های \fBprog\fR. .IP \fB\-\-seps\fR 4 .IX Item "--seps" چاپ یک جداکننده در ابتدا و انتها. .IP \fB\-\-sep\-before\fR 4 .IX Item "--sep-before" چاپ یک جداکننده در ابتدا. .IP \fB\-\-sep\-after\fR 4 .IX Item "--sep-after" چاپ یک جداکننده در انتها. .IP \fB\-\-no\-sub\-cats\fR 4 .IX Item "--no-sub-cats" تودرتو نکردن دسته‌بندی‌های فرعی در زیرمنوها. درستی دسته‌بندی به توصیف صحیح برنامه بستگی دارد که همیشه باید یک دسته‌بندی اصلی را مشخص کند. توصیف‌هایی که برچسب نادرست دارند در منوی \f(CW\*(C`Other\*(C'\fR مرتب می‌شوند. .IP "\fB\-o\fR, \fB\-\-output=FILE\fR" 4 .IX Item "-o, --output=FILE" نوشتن خروجی در \fIFILE\fR. .IP "\fB\-t\fR, \fB\-\-terminal=NAME\fR" 4 .IX Item "-t, --terminal=NAME" استفاده از \fINAME\fR برای راه‌اندازی شبیه‌ساز ترمینالی که از گزینه \*(Aq\-e\*(Aq پشتیبانی می‌کند. .IP "\fB\-s\fR, \fB\-\-no\-lone\-app\fR" 4 .IX Item "-s, --no-lone-app" تلاش برای شناسایی یک برنامه تکی بدون هیچ محتوای دیگر در زیرمنوهای پایینی و انتقال آن به زیرمنوی والد. این گزینه همچنین منوهایی را که فقط یک زیرمنو درون خود دارند شناسایی کرده و در صورت امکان آیتم‌های برنامه آن را به منوی والد منتقل می‌کند. .IP "\fB\-S\fR, \fB\-\-no\-lone\-hint\fR" 4 .IX Item "-S, --no-lone-hint" تزیین ورودی‌های برنامه‌ای که با گزینه \fB\-s\fR جابه‌جا شده‌اند با یک راهنما درباره منوی اصلی که در غیر این صورت در آن نمایش داده می‌شد. متضمن \fB\-s\fR است. .IP "\fB\-d TIMEOUT\fR, \fB\-\-deadline\-apps=TIMEOUT\fR" 4 .IX Item "-d TIMEOUT, --deadline-apps=TIMEOUT" تعیین مقدار معینی از مهلت زمانی (timeout) بر حسب میلی‌ثانیه، به طوری که خواندن پرونده‌های *.desktop (برای برنامه‌ها) تا آن زمان (یا کمی پس از آن) متوقف شود. این امر می‌تواند به جلوگیری از مسدود ماندن طولانی فراخواننده کمک کند. همچنین برای عملیات بعدی به \fB\-D\fR مراجعه کنید. .IP "\fB\-D TIMEOUT\fR, \fB\-\-deadline\-all=TIMEOUT\fR" 4 .IX Item "-D TIMEOUT, --deadline-all=TIMEOUT" تعیین مهلت زمانی کل بر حسب میلی‌ثانیه که پس از آن برنامه باید پایان یابد، صرف‌نظر از اینکه ساخت نهایی منو و خواندن تزیینات (که پس از خواندن پرونده‌های *.desktop اعمال می‌شود) به پایان رسیده باشد یا خیر. این امر باعث چاپ محتوای منو که تا آن لحظه محاسبه شده است می‌شود، بنابراین مهلت زمانی باید زمان مشخصی قبل از ضرب‌الاجل قطعی پایانی که برنامه باید در آن خاتمه یابد تنظیم شود. خروجی ممکن است فاقد ترجمه‌ها و آیکون‌ها باشد. .IP "\fB\-l LANGUAGE\fR, \fB\-\-lang=LANGUAGE\fR" 4 .IX Item "-l LANGUAGE, --lang=LANGUAGE" استفاده از LANGUAGE برای محلی‌سازی (locale) به جای متغیر محیطی \f(CW\*(C`LANG\*(C'\fR. .IP "\fB\-L MAX\fR, \fB\-\-limit\-max\-len=MAX\fR" 4 .IX Item "-L MAX, --limit-max-len=MAX" برش عنوان‌های محاسبه‌شده برنامه‌ها (پس از ترجمه و افزودن راهنماها، به \f(CW\*(C`\-C\*(C'\fR و \f(CW\*(C`\-g\*(C'\fR مراجعه کنید) در \f(CW\*(C`MAX\*(C'\fR نویسه و به دنبال آن سه نقطه (...). این امر می‌تواند به محدود کردن عرض منوها در مواردی که طول برخی ورودی‌ها بیش از حد بزرگ می‌شود کمک کند. .IP \fB\-\-flat\fR 4 .IX Item "--flat" نمایش برنامه‌ها از همه دسته‌بندی‌ها در یک سطح با عنوانی که حاوی اطلاعات دسته‌بندی به عنوان پیشوند است. .IP "\fB\-F sep\fR, \fB\-\-flat\-sep=sep\fR" 4 .IX Item "-F sep, --flat-sep=sep" هنگامی که با \f(CW\*(C`\-\-flat\*(C'\fR استفاده شود، دنباله نویسه‌های مشخص‌شده به عنوان جداکننده بین عنوان‌های بخش استفاده می‌شود. .IP "\fB\-m filter\fR, \fB\-\-match=filter\fR" 4 .IX Item "-m filter, --match=filter" مشخص کردن یک فیلتر برای نمایش تنها برنامه‌هایی که حاوی این زیررشته در عنوان خود هستند. .IP "\fB\-M filter\fR, \fB\-\-imatch=filter\fR" 4 .IX Item "-M filter, --imatch=filter" مانند \f(CW\*(C`\-\-match\*(C'\fR اما بدون حساسیت به حروف بزرگ و کوچک اعمال می‌شود. ممکن است با برخی تنظیمات محلی نتایج نادرستی ارائه دهد. .IP \fB\-\-match\-sec\fR 4 .IX Item "--match-sec" اعمال فیلتر از \f(CW\*(C`\-\-match\*(C'\fR یا \f(CW\*(C`\-\-imatch\*(C'\fR به هر دو مورد عنوان برنامه‌ها و بخش‌ها. .IP \fB\-\-match\-osec\fR 4 .IX Item "--match-osec" اعمال فیلتر از \f(CW\*(C`\-\-match\*(C'\fR یا \f(CW\*(C`\-\-imatch\*(C'\fR فقط به عنوان بخش‌ها. .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" نمایش خلاصه راهنمای استفاده در \fIstdout\fR و خروج. .IP "\fB\-V\fR, \fB\-\-version\fR" 4 .IX Item "-V, --version" نمایش نسخه برنامه در \fIstdout\fR و خروج. .IP "\fB\-C\fR, \fB\-\-copying\fR" 4 .IX Item "-C, --copying" نمایش مجوزهای رونوشت‌برداری در \fIstdout\fR برای برنامه و خروج. .SH "نحوه استفاده (USAGE)" .IX Subsection "USAGE" این ابزار معمولاً مستقیماً استفاده نمی‌شود. از آن به عنوان فایل اجرایی در یک ورودی \fBmenuprog\fR در \fBicewm\-menu\fR\|(5) استفاده می‌شود. .SH "مثال‌ها (EXAMPLES)" .IX Subsection "EXAMPLES" خط زیر در یک پرونده \fBicewm\-menu\fR\|(5) به صورت پویا مجموعه کاملی از منوها را برای دسترسی آسان به پرونده‌های \fI.desktop\fR تولید می‌کند که در یک زیرمنو به نام \f(CW\*(C`Desktop Apps\*(C'\fR اضافه شده است. .PP .Vb 1 \& menuprog "Desktop Apps" folder icewm\-menu\-fdo .Ve .PP همچنین می‌تواند مستقیماً مانند مثال زیر در منوی در حال بارگذاری جاسازی شود. در مواردی که برنامه محتوای مفیدی تولید می‌کند، یک خط جداکننده می‌تواند قبل یا بعد (یا هر دو) اضافه شود. .PP .Vb 1 \& includeprog icewm\-menu\-fdo \-\-seps .Ve .SH "محیط (ENVIRONMENT)" .IX Subsection "ENVIRONMENT" متغیرهای \fBXDG_DATA_HOME\fR یا \fBXDG_DATA_DIRS\fR طبق پیشنهاد مشخصات دایرکتوری پایه XDG در نظر گرفته می‌شوند. .PP متغیر \fBTERMINAL\fR ممکن است یک شبیه‌ساز ترمینال را تعریف کند که از گزینه \*(Aq\-e\*(Aq پشتیبانی می‌کند. اگر دستور مشخص‌شده یافت نشود، این گزینه نادیده گرفته شده و یک مقدار پیش‌فرض به جای آن استفاده می‌شود. .SH "سازگاری با استانداردها (CONFORMING TO)" .IX Subsection "CONFORMING TO" \&\fBicewm\-menu\-fdo\fR تا حدودی با مشخصات پرونده \fI.desktop\fR و منوی XDG مطابقت دارد؛ به "Desktop Entry Specification" (تاریخ: 2020\-04\-27، نسخه: Version 1.5) و "Desktop Menu Specification" (تاریخ: 20 August 2016، نسخه: Version 1.1) مراجعه کنید. .SH "نکات و هشدارها (CAVEATS)" .IX Subsection "CAVEATS" برنامه \fBicewm\-menu\-fdo\fR فقط زمانی ساخته می‌شود که بسته \fBicewm\fR\|(1) با گزینه \fB\-\-enable\-menus\-fdo\fR پیکربندی شده باشد و فقط با گزینه \fB\-\-enable\-i18n\fR کار می‌کند. .PP ادغام پرونده‌های منوی XDG از کیفیت متغیری برخوردار است و به شدت به صحت متاداده‌هایی مانند ترجمه‌ها و راهنماهای بخش‌ها (دسته‌بندی منو) بستگی دارد. .SH "همچنین ببینید (SEE ALSO)" .IX Subsection "SEE ALSO" Base Directory Specification, Desktop Entry Specification, Desktop Menu Specification, \&\fBicewm\fR\|(1), \&\fBicewm\-menu\fR\|(5), \&\fBicewm\-preferences\fR\|(5), \&\fBicewm\-programs\fR\|(5). .SH "گزارش باگ‌ها (BUGS)" .IX Subsection "BUGS" لطفاً باگ‌ها را در گزارش دهید. .SH "نویسنده (AUTHOR)" .IX Subsection "AUTHOR" Eduard Bloch . .PP برای اطلاع کامل از اعلان حق نشر و مجوزهای رونوشت‌برداری به \fB\-\-copying\fR مراجعه کنید. .SH "مجوز (LICENSE)" .IX Subsection "LICENSE" \&\fBIceWM\fR تحت مجوز GNU Library General Public License منتشر شده است. پرونده \fICOPYING\fR را در بسته توزیع مشاهده کنید یا از پرچم \fB\-\-copying\fR برای نمایش مجوزهای رونوشت‌برداری استفاده نمایید.