.\" -*- 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 "I3-DMENU-DESKTOP 1"
.TH I3-DMENU-DESKTOP 1 2026-02-06 "perl v5.42.0" "User Contributed Perl Documentation"
.\" 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)"
i3\-dmenu\-desktop \- اجرای برنامه‌های دسکتاپ بر اساس فایل‌های .desktop با dmenu
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 1
\&    i3\-dmenu\-desktop [\-\-dmenu=\*(Aqdmenu \-i\*(Aq] [\-\-entry\-type=name] [\-\-show\-duplicates]
.Ve
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور
.B i3\-dmenu\-desktop
یک اسکریپت است که نام (بومی‌سازی‌شده) برنامه‌ها را از فایل‌های
.B .desktop
استخراج می‌کند، با استفاده از
.BR dmenu \|(1)
انتخابی را در اختیار کاربر قرار می‌دهد و سپس برنامهٔ انتخاب‌شده را از طریق i3 اجرا می‌کند (جهت پشتیبانی از اعلان راه‌اندازی یا startup notification).
مزیت استفاده از فایل‌های
.B .desktop
به‌جای
.BR dmenu_run \|(1)
این است که
.B dmenu_run
.B تمامی
برنامه‌های اجرایی موجود در
\f(CW$PATH\fR
را ارائه می‌دهد، از جمله ابزارهای غیرتعاملی مانند
"sed".
همچنین، فایل‌های
.B .desktop
شامل نام مناسب، اطلاعاتی درباره اجرای برنامه در ترمینال و پشتیبانی آن از اعلان‌های راه‌اندازی هستند.
.PP
فایل‌های
.B .desktop
در مسیر
\f(CW$XDG_DATA_HOME\fR/applications
(به‌طور پیش‌فرض
\f(CW$HOME/.local/share/applications\fR)
و در زیرپوشهٔ "applications" از هر ورودی در
\f(CW$XDG_DATA_DIRS\fR
(به‌طور پیش‌فرض
\f(CW/usr/local/share/:/usr/share/\fR)
جستجو می‌شوند.
.PP
فایل‌های هم‌نام در
\f(CW$XDG_DATA_HOME\fR/applications
بر فایل‌های موجود در
\f(CW$XDG_DATA_DIRS\fR
اولویت دارند، بنابراین می‌توانید با کپی کردن فایل‌های
.B .desktop
سطح سیستم در پوشه محلی خود و اعمال تغییرات، بخش‌هایی از آن‌ها را بازنویسی کنید.
.PP
ابزار
.B i3\-dmenu\-desktop
مقدار "Name" را بسته به
.B LC_MESSAGES
به صورت نسخه بومی‌سازی‌شده طبق مشخصات ورودی دسکتاپ (Desktop Entry Specification) نمایش می‌دهد.
.PP
می‌توانید با الحاق نام فایل یا نشانی وب (به ترتیب کدهای فیلد
\f(CW%f\fR/\f(CW%F\fR
و
\f(CW%u\fR/\f(CW%U\fR
در فایل
\f(CW.desktop\fR)
به نام برنامه، آن را به عنوان آرگومان ارسال کنید. برای مثال، اگر می‌خواهید
"GNU Emacs 24"
را به همراه فایل
\f(CW/tmp/foobar.txt\fR
اجرا کنید، عبارت "emacs" را تایپ کرده، کلید TAB را فشار دهید، سپس " /tmp/foobar.txt" را تایپ کرده و ENTER را بزنید.
.PP
فایل‌های
.B .desktop
که دارای
.B Terminal=true
هستند با استفاده از
.BR i3\-sensible\-terminal \|(1)
اجرا می‌شوند.
.PP
فایل‌های
.B .desktop
که دارای
.B NoDisplay=true
یا
.B Hidden=true
هستند نادیده گرفته می‌شوند.
.PP
البته از UTF\-8 پشتیبانی می‌شود، اما dmenu از نمایش تمام گلیف‌ها پشتیبانی نمی‌کند. برای مثال،
\f(CWName[fi]=Pääte\fR
مربوط به
\f(CWxfce4\-terminal.desktop\fR
به‌درستی نمایش داده می‌شود، اما
\f(CWName[ru]=Терминал\fR
آن خیر.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-\-dmenu=command\fR 4
.IX Item "--dmenu=command"
دستور
.I command
را به‌جای
\*(Aq\f(CWdmenu \-i\fR\*(Aq
اجرا می‌کند. این گزینه می‌تواند برای ارسال پارامترهای سفارشی به dmenu، یا برای اجرای یک نسخه سفارشی (وصله‌شده) از dmenu توسط
.B i3\-dmenu\-desktop
استفاده شود.
.IP \fB\-\-entry\-type=type\fR 4
.IX Item "--entry-type=type"
مقدار (بومی‌سازی‌شده) "Name" (حالت
.BR type = name \fR)،
دستور (حالت
.BR type = command \fR)
یا نام فایل
(*.desktop)
(حالت
.BR type = filename \fR)
را در dmenu نمایش می‌دهد. این گزینه می‌تواند چندین بار مشخص شود. موارد تکراری حذف خواهند شد؛ گزینه
\*(Aq\fB\-\-show\-duplicates\fR\*(Aq
را ببینید.
.Sp
مثال‌ها عبارتند از "GNU Image Manipulation Program" (حالت
.BR type = name \fR)،
"gimp" (حالت
.BR type = command \fR)
و "libreoffice\-writer" (حالت
.BR type = filename \fR).
.IP \fB\-\-show\-duplicates\fR 4
.IX Item "--show-duplicates"
در صورتی که
\*(Aq\fB\-\-entry\-type\fR\*(Aq
چندین بار مشخص شده باشد، موارد تکراری را نمایش می‌دهد.
.SH "نسخه (VERSION)"
.IX Header "VERSION"
نسخه ۱.۵
.SH "نویسنده (AUTHOR)"
.IX Header "AUTHOR"
Michael Stapelberg, \f(CW\*(C`<michael at i3wm.org>\*(C'\fR
.SH "حق نشر و مجوز (LICENSE AND COPYRIGHT)"
.IX Header "LICENSE AND COPYRIGHT"
حق نشر ۲۰۱۲ Michael Stapelberg.
.PP
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز BSD بازتوزیع کرده و/یا تغییر دهید.