ICEWM-MENU-FDO(1) User Commands ICEWM-MENU-FDO(1) نام (NAME) icewm-menu-fdo - تولید منوی برنامه‌های سازگار با FreeDesktop.org برای IceWM خلاصه دستور (SYNOPSIS) icewm-menu-fdo [گزینه‌ها] [نام_پرونده] توضیحات (DESCRIPTION) icewm-menu-fdo یک منو برای مدیر پنجره IceWM از توصیف‌کننده‌های منوی XDG (معروف به پرونده‌های .desktop در FreeDesktop.Org) تولید می‌کند. با گنجاندن این مورد در icewm-menu(1)، برنامه‌های کاربردی سیستم در منوی شروع icewm در دسترس قرار می‌گیرند. آرگومان‌ها (ARGUMENTS) [نام_پرونده] آرگومان اختیاری نام_پرونده مسیر یک پرونده .desktop است. در صورت ارائه، icewm-menu-fdo برنامه را با استفاده از خط "Exec" از پرونده دسکتاپ اجرا می‌کند. گزینه‌ها (OPTIONS) -g, --generic گنجاندن نام عمومی در پرانتز در عنوان ورودی‌های prog. --seps چاپ یک جداکننده در ابتدا و انتها. --sep-before چاپ یک جداکننده در ابتدا. --sep-after چاپ یک جداکننده در انتها. --no-sub-cats تودرتو نکردن دسته‌بندی‌های فرعی در زیرمنوها. درستی دسته‌بندی به توصیف صحیح برنامه بستگی دارد که همیشه باید یک دسته‌بندی اصلی را مشخص کند. توصیف‌هایی که برچسب نادرست دارند در منوی "Other" مرتب می‌شوند. -o, --output=FILE نوشتن خروجی در FILE. -t, --terminal=NAME استفاده از NAME برای راه‌اندازی شبیه‌ساز ترمینالی که از گزینه '-e' پشتیبانی می‌کند. -s, --no-lone-app تلاش برای شناسایی یک برنامه تکی بدون هیچ محتوای دیگر در زیرمنوهای پایینی و انتقال آن به زیرمنوی والد. این گزینه همچنین منوهایی را که فقط یک زیرمنو درون خود دارند شناسایی کرده و در صورت امکان آیتم‌های برنامه آن را به منوی والد منتقل می‌کند. -S, --no-lone-hint تزیین ورودی‌های برنامه‌ای که با گزینه -s جابه‌جا شده‌اند با یک راهنما درباره منوی اصلی که در غیر این صورت در آن نمایش داده می‌شد. متضمن -s است. -d TIMEOUT, --deadline-apps=TIMEOUT تعیین مقدار معینی از مهلت زمانی (timeout) بر حسب میلی‌ثانیه، به طوری که خواندن پرونده‌های *.desktop (برای برنامه‌ها) تا آن زمان (یا کمی پس از آن) متوقف شود. این امر می‌تواند به جلوگیری از مسدود ماندن طولانی فراخواننده کمک کند. همچنین برای عملیات بعدی به -D مراجعه کنید. -D TIMEOUT, --deadline-all=TIMEOUT تعیین مهلت زمانی کل بر حسب میلی‌ثانیه که پس از آن برنامه باید پایان یابد، صرف‌نظر از اینکه ساخت نهایی منو و خواندن تزیینات (که پس از خواندن پرونده‌های *.desktop اعمال می‌شود) به پایان رسیده باشد یا خیر. این امر باعث چاپ محتوای منو که تا آن لحظه محاسبه شده است می‌شود، بنابراین مهلت زمانی باید زمان مشخصی قبل از ضرب‌الاجل قطعی پایانی که برنامه باید در آن خاتمه یابد تنظیم شود. خروجی ممکن است فاقد ترجمه‌ها و آیکون‌ها باشد. -l LANGUAGE, --lang=LANGUAGE استفاده از LANGUAGE برای محلی‌سازی (locale) به جای متغیر محیطی "LANG". -L MAX, --limit-max-len=MAX برش عنوان‌های محاسبه‌شده برنامه‌ها (پس از ترجمه و افزودن راهنماها، به "-C" و "-g" مراجعه کنید) در "MAX" نویسه و به دنبال آن سه نقطه (...). این امر می‌تواند به محدود کردن عرض منوها در مواردی که طول برخی ورودی‌ها بیش از حد بزرگ می‌شود کمک کند. --flat نمایش برنامه‌ها از همه دسته‌بندی‌ها در یک سطح با عنوانی که حاوی اطلاعات دسته‌بندی به عنوان پیشوند است. -F sep, --flat-sep=sep هنگامی که با "--flat" استفاده شود، دنباله نویسه‌های مشخص‌شده به عنوان جداکننده بین عنوان‌های بخش استفاده می‌شود. -m filter, --match=filter مشخص کردن یک فیلتر برای نمایش تنها برنامه‌هایی که حاوی این زیررشته در عنوان خود هستند. -M filter, --imatch=filter مانند "--match" اما بدون حساسیت به حروف بزرگ و کوچک اعمال می‌شود. ممکن است با برخی تنظیمات محلی نتایج نادرستی ارائه دهد. --match-sec اعمال فیلتر از "--match" یا "--imatch" به هر دو مورد عنوان برنامه‌ها و بخش‌ها. --match-osec اعمال فیلتر از "--match" یا "--imatch" فقط به عنوان بخش‌ها. -h, --help نمایش خلاصه راهنمای استفاده در stdout و خروج. -V, --version نمایش نسخه برنامه در stdout و خروج. -C, --copying نمایش مجوزهای رونوشت‌برداری در stdout برای برنامه و خروج. نحوه استفاده (USAGE) این ابزار معمولاً مستقیماً استفاده نمی‌شود. از آن به عنوان فایل اجرایی در یک ورودی menuprog در icewm-menu(5) استفاده می‌شود. مثال‌ها (EXAMPLES) خط زیر در یک پرونده icewm-menu(5) به صورت پویا مجموعه کاملی از منوها را برای دسترسی آسان به پرونده‌های .desktop تولید می‌کند که در یک زیرمنو به نام "Desktop Apps" اضافه شده است. menuprog "Desktop Apps" folder icewm-menu-fdo همچنین می‌تواند مستقیماً مانند مثال زیر در منوی در حال بارگذاری جاسازی شود. در مواردی که برنامه محتوای مفیدی تولید می‌کند، یک خط جداکننده می‌تواند قبل یا بعد (یا هر دو) اضافه شود. includeprog icewm-menu-fdo --seps محیط (ENVIRONMENT) متغیرهای XDG_DATA_HOME یا XDG_DATA_DIRS طبق پیشنهاد مشخصات دایرکتوری پایه XDG در نظر گرفته می‌شوند. متغیر TERMINAL ممکن است یک شبیه‌ساز ترمینال را تعریف کند که از گزینه '-e' پشتیبانی می‌کند. اگر دستور مشخص‌شده یافت نشود، این گزینه نادیده گرفته شده و یک مقدار پیش‌فرض به جای آن استفاده می‌شود. سازگاری با استانداردها (CONFORMING TO) icewm-menu-fdo تا حدودی با مشخصات پرونده .desktop و منوی XDG مطابقت دارد؛ به "Desktop Entry Specification" (تاریخ: 2020-04-27، نسخه: Version 1.5) و "Desktop Menu Specification" (تاریخ: 20 August 2016، نسخه: Version 1.1) مراجعه کنید. نکات و هشدارها (CAVEATS) برنامه icewm-menu-fdo فقط زمانی ساخته می‌شود که بسته icewm(1) با گزینه --enable-menus-fdo پیکربندی شده باشد و فقط با گزینه --enable-i18n کار می‌کند. ادغام پرونده‌های منوی XDG از کیفیت متغیری برخوردار است و به شدت به صحت متاداده‌هایی مانند ترجمه‌ها و راهنماهای بخش‌ها (دسته‌بندی منو) بستگی دارد. همچنین ببینید (SEE ALSO) Base Directory Specification, Desktop Entry Specification, Desktop Menu Specification, icewm(1), icewm-menu(5), icewm-preferences(5), icewm-programs(5). گزارش باگ‌ها (BUGS) لطفاً باگ‌ها را در گزارش دهید. نویسنده (AUTHOR) Eduard Bloch . برای اطلاع کامل از اعلان حق نشر و مجوزهای رونوشت‌برداری به --copying مراجعه کنید. مجوز (LICENSE) IceWM تحت مجوز GNU Library General Public License منتشر شده است. پرونده COPYING را در بسته توزیع مشاهده کنید یا از پرچم --copying برای نمایش مجوزهای رونوشت‌برداری استفاده نمایید. icewm 4.1.0 2026-08-06 ICEWM-MENU-FDO(1)