نام (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)

لطفاً باگ‌ها را در https://github.com/ice-wm/icewm/issues گزارش دهید.

نویسنده (AUTHOR)

Eduard Bloch <mailto:edi@gmx.de>.

برای اطلاع کامل از اعلان حق نشر و مجوزهای رونوشت‌برداری به --copying مراجعه کنید.

مجوز (LICENSE)

IceWM تحت مجوز GNU Library General Public License منتشر شده است. پرونده COPYING را در بسته توزیع مشاهده کنید یا از پرچم --copying برای نمایش مجوزهای رونوشت‌برداری استفاده نمایید.