نام (NAME)

i3-dmenu-desktop - اجرای برنامه‌های دسکتاپ بر اساس فایل‌های .desktop با dmenu

خلاصه دستور (SYNOPSIS)

i3-dmenu-desktop [--dmenu='dmenu -i'] [--entry-type=name] [--show-duplicates]

توضیحات (DESCRIPTION)

دستور i3-dmenu-desktop یک اسکریپت است که نام (بومی‌سازی‌شده) برنامه‌ها را از فایل‌های .desktop استخراج می‌کند، با استفاده از dmenu(1) انتخابی را در اختیار کاربر قرار می‌دهد و سپس برنامهٔ انتخاب‌شده را از طریق i3 اجرا می‌کند (جهت پشتیبانی از اعلان راه‌اندازی یا startup notification). مزیت استفاده از فایل‌های .desktop به‌جای dmenu_run(1) این است که dmenu_run تمامی برنامه‌های اجرایی موجود در $PATH را ارائه می‌دهد، از جمله ابزارهای غیرتعاملی مانند "sed". همچنین، فایل‌های .desktop شامل نام مناسب، اطلاعاتی درباره اجرای برنامه در ترمینال و پشتیبانی آن از اعلان‌های راه‌اندازی هستند.

فایل‌های .desktop در مسیر $XDG_DATA_HOME/applications (به‌طور پیش‌فرض $HOME/.local/share/applications) و در زیرپوشهٔ "applications" از هر ورودی در $XDG_DATA_DIRS (به‌طور پیش‌فرض /usr/local/share/:/usr/share/) جستجو می‌شوند.

فایل‌های هم‌نام در $XDG_DATA_HOME/applications بر فایل‌های موجود در $XDG_DATA_DIRS اولویت دارند، بنابراین می‌توانید با کپی کردن فایل‌های .desktop سطح سیستم در پوشه محلی خود و اعمال تغییرات، بخش‌هایی از آن‌ها را بازنویسی کنید.

ابزار i3-dmenu-desktop مقدار "Name" را بسته به LC_MESSAGES به صورت نسخه بومی‌سازی‌شده طبق مشخصات ورودی دسکتاپ (Desktop Entry Specification) نمایش می‌دهد.

می‌توانید با الحاق نام فایل یا نشانی وب (به ترتیب کدهای فیلد %f/%F و %u/%U در فایل .desktop) به نام برنامه، آن را به عنوان آرگومان ارسال کنید. برای مثال، اگر می‌خواهید "GNU Emacs 24" را به همراه فایل /tmp/foobar.txt اجرا کنید، عبارت "emacs" را تایپ کرده، کلید TAB را فشار دهید، سپس " /tmp/foobar.txt" را تایپ کرده و ENTER را بزنید.

فایل‌های .desktop که دارای Terminal=true هستند با استفاده از i3-sensible-terminal(1) اجرا می‌شوند.

فایل‌های .desktop که دارای NoDisplay=true یا Hidden=true هستند نادیده گرفته می‌شوند.

البته از UTF-8 پشتیبانی می‌شود، اما dmenu از نمایش تمام گلیف‌ها پشتیبانی نمی‌کند. برای مثال، Name[fi]=Pääte مربوط به xfce4-terminal.desktop به‌درستی نمایش داده می‌شود، اما Name[ru]=Терминал آن خیر.

گزینه‌ها (OPTIONS)

--dmenu=command: دستور command را به‌جای 'dmenu -i' اجرا می‌کند. این گزینه می‌تواند برای ارسال پارامترهای سفارشی به dmenu، یا برای اجرای یک نسخه سفارشی (وصله‌شده) از dmenu توسط i3-dmenu-desktop استفاده شود.
--entry-type=type: مقدار (بومی‌سازی‌شده) "Name" (حالت type=name)، دستور (حالت type=command) یا نام فایل (*.desktop) (حالت type=filename) را در dmenu نمایش می‌دهد. این گزینه می‌تواند چندین بار مشخص شود. موارد تکراری حذف خواهند شد؛ گزینه '--show-duplicates' را ببینید.
مثال‌ها عبارتند از "GNU Image Manipulation Program" (حالت type=name)، "gimp" (حالت type=command) و "libreoffice-writer" (حالت type=filename).
--show-duplicates: در صورتی که '--entry-type' چندین بار مشخص شده باشد، موارد تکراری را نمایش می‌دهد.

نسخه (VERSION)

نسخه ۱.۵

نویسنده (AUTHOR)

Michael Stapelberg, "<michael at i3wm.org>"

حق نشر و مجوز (LICENSE AND COPYRIGHT)

حق نشر ۲۰۱۲ Michael Stapelberg.

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز BSD بازتوزیع کرده و/یا تغییر دهید.