.\" Automatically generated by Pandoc 3.2
.\"
.TH "rofi" "1" "" "rofi" "General Commands Manual"
.SH "نام (NAME)"
\f[B]rofi\f[R] \- پنجره‌ابزار، اجراکننده برنامه‌ها، دیالوگ ssh، جایگزین dmenu و موارد دیگر
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]rofi\f[R] [ \-show \f[I]mode\f[R] ]|[ \-dmenu ]|[ \-e \f[I]msg\f[R]
] CONFIGURATION
.SH "توضیحات (DESCRIPTION)"
دستور \f[B]rofi\f[R] یک پنجره‌ابزار پاپ‌آپ X11، کادر محاوره‌ای اجرا، جایگزین
dmenu و مواردی فراتر از این‌ها است.
تمرکز این ابزار بر سرعت عملکرد بالا و کمترین میزان حواس‌پرتی کاربر است.
این برنامه از ناوبری با صفحه‌کلید و ماوس، تایپ برای فیلتر کردن، جستجوی
نشانه‌ای (tokenized) و قابلیت‌های متعدد دیگر پشتیبانی می‌کند.
.SH "نحوه استفاده (USAGE)"
کارکرد اصلی \f[B]rofi\f[R] کمک به جریان کاری شما است که امکان جابه‌جایی
سریع میان پنجره‌ها، اجرای برنامه‌ها یا ورود به ماشین‌های دوردست از طریق
\f[B]ssh\f[R] را فراهم می‌سازد.
حالت‌های مختلفی (\f[I]modes\f[R]) برای انواع گوناگون اقدامات وجود دارد.
ابزار \f[B]rofi\f[R] یک برنامه مستقل است و نباید درون اسکریپت‌ها ادغام
گردد.
جهت یکپارچه‌سازی در اسکریپت‌ها، دارای یک حالت ویژه است که به عنوان جایگزین
مستقیم (drop\-in) برای \f[B]dmenu(1)\f[R] عمل می‌کند.
بخش شبیه‌سازی dmenu را در ادامه ببینید.
.SS "اجرای rofi (Running rofi)"
برای اجرای مستقیم \f[B]rofi\f[R] در یک حالت مشخص، حالت را با دستور
\f[B]rofi \-show <mode>\f[R] تعیین کنید.
جهت نمایش دیالوگ \f[B]drun\f[R]:
.IP
.EX
    rofi \-show drun
.EE
.PP
یک پیکربندی کاربردی در مدیر پنجره‌های مینیمال، ترکیب حالت‌های
\f[B]drun\f[R] و \f[B]run\f[R] با حالت \f[B]window\f[R] است:
.IP
.EX
  rofi \-show combi \-modes combi \-combi\-modes \[dq]window,drun,run\[dq]
.EE
.PP
در این چیدمان، ابتدا تمام برنامه‌های باز فهرست می‌شوند و سپس تمام
برنامه‌های نصب‌شده نمایش می‌یابند.
بنابراین اگر firefox را تایپ کرده و Enter را فشار دهید، به فایرفاکس در حال
اجرا جابه‌جا می‌شوید یا در صورتی که در حال اجرا نباشد، اجرا خواهد شد.
.SS "شبیه‌سازی dmenu (Emulating dmenu)"
ابزار \f[B]rofi\f[R] می‌تواند در صورت اجرا با فلگ \f[B]\-dmenu\f[R]،
برنامه \f[B]dmenu(1)\f[R] (منوی پویا برای X11) را شبیه‌سازی کند.
.PP
برای اطلاعات بیشتر به \f[B]rofi\-dmenu(5)\f[R] مراجعه فرمایید.
.SS "نمایش پیام خطا (Display Error message)"
دیالوگ خطای \f[B]rofi\f[R] را نیز می‌توان از خط فرمان فراخوانی کرد.
.IP
.EX
    rofi \-e \[dq]my message\[dq]
.EE
.PP
پشتیبانی از نشانه‌گذاری (Markup) را می‌توان فعال کرد، گزینه‌های پیکربندی را ببینید.
.SH "پیکربندی (CONFIGURATION)"
در حال حاضر سه روش برای تنظیم گزینه‌های پیکربندی وجود دارد
(به ترتیبی که در زیر ارزیابی می‌شوند):
.IP \[bu] 2
فایل پیکربندی سیستم (به عنوان مثال \f[B]/etc/rofi.rasi\f[R]).
ابتدا \f[B]XDG_CONFIG_DIRS\f[R] و سپس \f[B]SYSCONFDIR\f[R]
(که در زمان کامپایل ارسال می‌شود) بررسی می‌گردد.
اولین فایل کانفیگی را که بیابد بارگذاری می‌کند و چندین فایل کانفیگ
سیستمی را با یکدیگر ادغام نمی‌نماید.
.IP \[bu] 2
فایل پوسته Rasi: فرمت جدید \f[I]theme\f[R] را می‌توان برای تنظیم مقادیر
پیکربندی به کار برد.
.IP \[bu] 2
گزینه‌های خط فرمان: آرگومان‌هایی که به \f[B]rofi\f[R] ارسال می‌شوند.
.PP
برای دریافت یک فایل پیکربندی الگو، دستور زیر را اجرا کنید: \f[B]rofi \-dump\-config >
config.rasi\f[R]
.PP
این خروجی حاوی تمام گزینه‌های پیکربندی فعلی (به صورت کامنت‌شده) خواهد بود
و گزینه‌های تغییریافته از حالت کامنت خارج هستند.
.PP
برای دریافت فایل کانفیگ الگو که پوسته آیکون را تعیین می‌کند اجرا کنید: \f[B]rofi
\-icon\-theme hicolor \-dump\-config\f[R].
.PP
\f[B]اکیداً\f[R] توصیه می‌شود که از این فایل به عنوان نقطه شروعی برای
پیکربندی خود بهره بگیرید.
.PP
یک بخش پیکربندی خالی در فایل کانفیگ به این صورت است:
.IP
.EX
configuration {
 \f[B]// set config options here\f[R]
}
.EE
.PP
بیشتر گزینه‌های پیکربندی ذکر شده در زیر (به جز گزینه‌هایی مانند
\f[B]\-show\f[R] و \f[B]\-dump\-config\f[R] که برای یک اجرای منفرد اعمال
می‌شوند) را می‌توان در اینجا تنظیم کرد.
.PP
به عنوان مثال برای تنظیم مقدار dpi روی 72:
.IP
.EX
configuration {
 dpi: 72;
}
.EE
.PP
سیستم پیکربندی از انواع داده‌های زیر پشتیبانی می‌کند:
.IP \[bu] 2
string (رشته)
.IP \[bu] 2
integer (عدد صحیح علامت‌دار و بدون علامت)
.IP \[bu] 2
char (نویسه)
.IP \[bu] 2
boolean (بولی)
.IP \[bu] 2
lists (لیست‌ها)
.PP
برای ساختار نحوی این گزینه‌ها، صفحه راهنمای \f[B]rofi\-theme(5)\f[R]
را ببینید.
.PP
برای استفاده در خط فرمان، گزینه‌های بولی ساختار متفاوتی در خط فرمان دارند.
مثال برای فعال‌سازی گزینه X:
.IP
.EX
    \-X
.EE
.PP
برای غیرفعال‌سازی گزینه X:
.IP
.EX
    \-no\-X
.EE
.PP
در ادامه فهرستی از مهم‌ترین گزینه‌ها آمده است:
.SS "عمومی (General)"
.TP
\f[B]\-help\f[R]
گزینه help فهرست کاملی از گزینه‌های خط فرمان و مقادیر تنظیم‌شده فعلی
را نمایش می‌دهد.
این موارد شامل گزینه‌های پویا (تولیدشده در زمان اجرا) نیز می‌شوند.
.TP
\f[B]\-info\f[R]
گزینه info اطلاعات مفیدی را جهت درج هنگام گزارش یک اشکال نمایش
می‌دهد.
این اطلاعات شامل گزینه‌های زمان کامپایل، مانیتورهای شناسایی‌شده و موارد
دیگر است.
لطفاً پیش از ارسال آنلاین، خروجی را از نظر وجود اطلاعات شخصی بررسی کنید.
.TP
\f[B]\-version\f[R]
نسخه \f[B]rofi\f[R] را نمایش داده و خارج می‌شود.
.TP
\f[B]\-dump\-config\f[R]
پیکربندی فعال فعلی را در فرمت rasi روی خروجی استاندارد (stdout) ریخته
و خارج می‌شود.
اطلاعات مربوط به فرمت rasi را می‌توان در صفحه راهنمای
\f[B]rofi\-theme(5)\f[R] یافت.
.TP
\f[B]\-dump\-theme\f[R]
پوسته فعال فعلی را در فرمت rasi روی خروجی استاندارد ریخته و خارج می‌شود.
.TP
\f[B]\-rasi\-validate\f[R] \f[I]filename\f[R]
تلاش برای تجزیه فایل؛ در صورت موفقیت کد 0 و در صورت شکست مقداری غیر صفر
برمی‌گرداند.
.TP
\f[B]\-list\-keybindings\f[R]
فهرست کردن تمام کلیدهای میانبر شناخته‌شده بدون تلاش برای تجزیه آن‌ها.
از این گزینه می‌توان برای بررسی کلیدهای تکراری استفاده کرد.
.TP
\f[B]\-threads\f[R] \f[I]num\f[R]
تعیین تعداد رشته‌هایی (threads) که \f[B]rofi\f[R] باید استفاده کند:
.RS
.IP \[bu] 2
0: تشخیص خودکار تعداد رشته‌های سخت‌افزاری پشتیبانی‌شده.
.IP \[bu] 2
1: غیرفعال کردن چندرشته‌ای
.IP \[bu] 2
2..n: تعیین حداکثر تعداد رشته‌های مورد استفاده در استخر رشته‌ها (thread pool).
.PP
پیش‌فرض: Autodetect (تشخیص خودکار)
.RE
.TP
\f[B]\-display\f[R] \f[I]display\f[R]
سرور X مورد نظر برای برقراری ارتباط.
پیش‌فرض \f[B]$DISPLAY\f[R] است.
.TP
\f[B]\-dmenu\f[R]
اجرای \f[B]rofi\f[R] در حالت dmenu.
این ویژگی امکان تعامل با اسکریپت‌ها را فراهم می‌سازد.
در حالت \f[B]dmenu\f[R]، دستور \f[B]rofi\f[R] از ورودی استاندارد (STDIN)
می‌خواند و در خروجی استاندارد (STDOUT) می‌نویسد.
مثالی ساده برای نمایش سه گزینه از پیش تعریف‌شده:
.RS
.IP
.EX
    echo \-e \[dq]Option #1\[rs]nOption #2\[rs]nOption #3\[dq] \f[B]|\f[R] rofi \-dmenu
.EE
.PP
یا دریافت گزینه‌ها از یک اسکریپت:
.IP
.EX
    \[ti]/my_script.sh \f[B]|\f[R] rofi \-dmenu
.EE
.PP
برای اطلاعات بیشتر صفحه راهنمای \f[B]rofi\-dmenu(5)\f[R] را ببینید.
.RE
.TP
\f[B]\-show\f[R] \f[I]mode\f[R]
باز کردن \f[B]rofi\f[R] در یک حالت خاص.
حالت‌های موجود عبارتند از \f[B]window\f[R]، \f[B]run\f[R]، \f[B]drun\f[R]،
\f[B]ssh\f[R] و \f[B]combi\f[R].
آرگومان ویژه \f[B]keys\f[R] را می‌توان برای باز کردن فهرستی قابل جستجو
از کلیدهای میانبر پشتیبانی‌شده استفاده کرد (صفحه راهنمای \f[B]rofi\-keys(5)\f[R] را ببینید).
.RS
.PP
برای نمایش دیالوگ run:
.IP
.EX
    rofi \-show run
.EE
.PP
اگر \f[B]\-show\f[R] آخرین گزینه ارسال‌شده به rofi باشد، اولین حالت
فعال‌شده نمایش داده می‌شود.
.RE
.TP
\f[B]\-modes\f[R] \f[I]mode1,mode2\f[R]
تعیین فهرستی مرتب و جداشده با کاما از حالت‌های فعال.
حالت‌های فعال را می‌توان در زمان اجرا تغییر داد.
کلید پیش‌فرض \f[B]Ctrl+Tab\f[R] است.
اگر حالتی تعیین نشود، تمام حالت‌های پیکربندی‌شده فعال خواهند بود.
برای نمایش فقط اجراکننده‌های \f[B]run\f[R] و \f[B]ssh\f[R]:
.RS
.IP
.EX
    rofi \-modes \[dq]run,ssh\[dq] \-show run
.EE
.PP
حالت‌های سفارشی را می‌توان با استفاده از حالت داخلی \f[B]script\f[R] اضافه کرد.
هر یک از این حالت‌ها دو پارامتر دارد:
.IP
.EX
<name>:<script>
.EE
.PP
مثال: داشتن حالتی به نام `Workspaces' با استفاده از اسکریپت
\f[B]i3_switch_workspaces.sh\f[R]:
.IP
.EX
    rofi \-modes \[dq]window,run,ssh,Workspaces:i3_switch_workspaces.sh\[dq] \-show Workspaces
.EE
.PP
نکات: مدیر پنجره i3 در هنگام تعیین دستور exec با کاما سازگار نیست.
در این مورد، می‌توان از \f[B]#\f[R] به عنوان جداکننده استفاده کرد.
.PP
\f[B]نکته\f[R]: نام می‌تواند شامل فاصله (space) باشد:
.IP
.EX
    rofi \-modes \[dq]My File Browser:fb.sh\[dq] \-show \[dq]My File Browser\[dq]
.EE
.RE
.TP
\f[B]\-case\-sensitive\f[R]
شروع در حالت حساس به حروف بزرگ و کوچک.
این گزینه را می‌توان در زمان اجرا با استفاده از میانبر کلیدی
\f[B]\-kb\-toggle\-case\-sensitivity\f[R] تغییر داد.
.TP
\f[B]\-case\-smart\f[R]
شروع در حالت حساسیت هوشمند حروف، مشابه با رفتار \f[B]smartcase\f[R] در vim،
که حساسیت به حروف را بر اساس ورودی تعیین می‌کند.
در صورت فعال بودن، تنظیمات \f[B]\-case\-sensitive\f[R] نادیده گرفته می‌شود.
.TP
\f[B]\-cycle\f[R]
چرخش در فهرست نتایج.
پیش‌فرض `true' است.
.TP
\f[B]\-filter\f[R] \f[I]filter\f[R]
فیلتر کردن فهرست با قرار دادن متن در نوار ورودی روی \f[I]filter\f[R].
.TP
\f[B]\-config\f[R] \f[I]filename\f[R]
بارگذاری یک فایل پیکربندی جایگزین.
.TP
\f[B]\-cache\-dir\f[R] \f[I]filename\f[R]
دایرکتوری مورد استفاده برای قرار دادن فایل‌های موقت، مانند تاریخچه.
.TP
\f[B]\-scroll\-method\f[R] \f[I]method\f[R]
انتخاب روش پیمایش.
0: صفحه‌ای (Per page)، 1: پیوسته (continuous).
.TP
\f[B]\-normalize\-match\f[R]
نرمال‌سازی رشته پیش از تطبیق؛ بنابراین \f[B]o\f[R] با \f[B]ö\f[R] و
\f[B]é\f[R] با \f[B]e\f[R] تطبیق می‌یابد.
این پیاده‌سازی کامل نیست، اما به خوبی کار می‌کند.
در حال حاضر، برجسته‌سازی بخش تطبیق‌یافته را غیرفعال می‌کند.
.TP
\f[B]\-no\-lazy\-grab\f[R]
غیرفعال کردن گرفتن تنبل (lazy grab)؛ این امر گرفتن صفحه‌کلید را پیش از
نمایش رابط کاربری گرافیکی اجباری می‌کند.
.TP
\f[B]\-no\-plugins\f[R]
غیرفعال کردن بارگذاری افزونه‌ها.
.TP
\f[B]\-plugin\-path\f[R] \f[I]directory\f[R]
تعیین دایرکتوری که \f[B]rofi\f[R] باید در آن به دنبال افزونه‌ها بگردد.
.TP
\f[B]\-show\-icons\f[R]
نمایش آیکون برنامه‌ها در حالت‌های \f[B]drun\f[R] و \f[B]window\f[R].
.TP
\f[B]\-icon\-theme\f[R]
تعیین پوسته آیکون مورد استفاده.
در صورت عدم تعیین، پوسته پیش‌فرض محیط رومیزی استفاده می‌شود؛ پوسته‌های
\f[I]Adwaita\f[R] و \f[I]gnome\f[R] به عنوان پوسته‌های جایگزین عمل می‌کنند.
.TP
\f[B]\-markup\f[R]
استفاده از نشانه‌گذاری Pango برای قالب‌بندی خروجی در هر کجا که امکان‌پذیر باشد.
.TP
\f[B]\-normal\-window\f[R]
وادار کردن \f[B]rofi\f[R] به داشتن واکنشی مانند یک پنجره معمولی برنامه.
برای اسکریپت‌هایی مانند Clerk که اساساً یک برنامه هستند مفید است.
.TP
\f[B]\-transient\-window\f[R]
وادار کردن \f[B]rofi\f[R] به رفتاری مانند یک دیالوگ مدال که نسبت به
پنجره دارای فوکوس فعلی گذرا (transient) است.
زمانی مفید است که از میانبر صفحه‌کلید برای اجرا و نمایش روی پنجره‌ای که
با آن کار می‌کنید استفاده می‌کنید.
.TP
\f[B]\-[no\-]steal\-focus\f[R]
وادار کردن rofi به ربودن فوکوس هنگام اجرا و بازگرداندن آن به پنجره قبلی
هنگام بسته شدن.
.TP
\f[B]\-refilter\-timeout\-limit\f[R]
حد زمانی (به میلی‌ثانیه) که فیلتر می‌تواند پیش از تغییر از حالت آنی به
تاخیری مصرف کند.
.RS
.PP
پیش‌فرض: 300
.PP
می‌توان برای هر حالت یک آیکون جایگزین تعیین کرد:
.IP
.EX
configuration {
    <mode>{
      fallback\-icon: \[dq]<icon name>\[dq];
    }
}
.EE
.PP
مثال
.IP
.EX
configuration {
    run,drun {
      fallback\-icon: \[dq]application\-x\-addon\[dq];
    }
}
.EE
.RE
.SS "تطبیق (Matching)"
.TP
\f[B]\-matching\f[R] \f[I]method\f[R]
تعیین الگوریتم تطبیق مورد استفاده.
در حال حاضر، روش‌های زیر پشتیبانی می‌شوند:
.RS
.IP \[bu] 2
\f[B]normal\f[R]: تطبیق کل رشته
.IP \[bu] 2
\f[B]regex\f[R]: تطبیق با ورودی عبارت منظم (regex)
.IP \[bu] 2
\f[B]glob\f[R]: تطبیق با الگوی گلوب (glob)
.IP \[bu] 2
\f[B]fuzzy\f[R]: انجام تطبیق فازی (تقریبی)
.IP \[bu] 2
\f[B]prefix\f[R]: تطبیق با پیشوند
.PP
پیش‌فرض: \f[I]normal\f[R]
.PP
می‌توان چندین روش تطبیق را در فهرستی جداشده با کاما تعیین کرد.
کلیدهای میانبر تطبیق بالا/پایین امکان جابه‌جایی چرخشی در زمان اجرا را فراهم می‌کنند.
.PP
نکته: تطبیق با glob ممکن است برای فهرست‌های بزرگ کند باشد.
.RE
.TP
\f[B]\-tokenize\f[R]
نشانه‌گذاری (توکن‌سازی) ورودی.
.TP
\f[B]\-drun\-categories\f[R] \f[I]category1\f[R],\f[I]category2\f[R]
فقط نمایش فایل‌های Desktop که در دسته‌بندی‌های فهرست‌شده قرار دارند.
.TP
\f[B]\-drun\-exclude\-categories\f[R] \f[I]category1\f[R],\f[I]category2\f[R]
مستثنی کردن فایل‌های Desktop که در دسته‌بندی‌های فهرست‌شده قرار دارند.
.TP
\f[B]\-drun\-match\-fields\f[R] \f[I]field1\f[R],\f[I]field2\f[R],\&...
هنگام استفاده از \f[B]drun\f[R]، فقط با فیلدهای تعیین‌شده مدخل Desktop تطبیق یابد.
فیلدهای مختلف عبارتند از:
.RS
.IP \[bu] 2
\f[B]name\f[R]: نام برنامه
.IP \[bu] 2
\f[B]generic\f[R]: نام عمومی برنامه
.IP \[bu] 2
\f[B]exec\f[R]: فایل اجرایی برنامه
.IP \[bu] 2
\f[B]categories\f[R]: دسته‌بندی‌های برنامه
.IP \[bu] 2
\f[B]comment\f[R]: توضیحات برنامه
.IP \[bu] 2
\f[B]all\f[R]: تمام موارد بالا
.PP
پیش‌فرض: \f[I]name,generic,exec,categories,keywords\f[R]
.RE
.TP
\f[B]\-drun\-display\-format\f[R]
رشته قالب‌بندی برای دیالوگ \f[B]drun\f[R]:
.RS
.IP \[bu] 2
\f[B]name\f[R]: نام برنامه
.IP \[bu] 2
\f[B]generic\f[R]: نام عمومی برنامه
.IP \[bu] 2
\f[B]exec\f[R]: فایل اجرایی برنامه
.IP \[bu] 2
\f[B]categories\f[R]: دسته‌بندی‌های برنامه
.IP \[bu] 2
\f[B]comment\f[R]: توضیحات برنامه
.IP \[bu] 2
\f[B]url\f[R]: آدرس اینترنتی در صورت فایل دسکتاپ از نوع پیوند (link)
.PP
برای قالب‌بندی خروجی می‌توان از نشانه‌گذاری Pango استفاده کرد.
.PP
پیش‌فرض: \f[B]{name} [<span weight=\[aq]light\[aq]
size=\[aq]small\[aq]><i>({generic})</i></span>]\f[R]
.PP
نکته: فقط فیلدهای فعال در \f[B]\-drun\-match\-fields\f[R] را می‌توان در رشته قالب‌بندی به کار برد.
.RE
.TP
\f[B]\-[no\-]drun\-show\-actions\f[R]
نمایش اکشن‌های موجود در فایل‌های Desktop.
.RS
.PP
پیش‌فرض: false
.RE
.TP
\f[B]\-window\-match\-fields\f[R] \f[I]field1\f[R],\f[I]field2\f[R],\&...
هنگام استفاده از حالت window، فقط با فیلدهای تعیین‌شده تطبیق یابد.
فیلدهای مختلف عبارتند از:
.RS
.IP \[bu] 2
\f[B]title\f[R]: عنوان پنجره
.IP \[bu] 2
\f[B]class\f[R]: کلاس پنجره
.IP \[bu] 2
\f[B]role\f[R]: نقش پنجره
.IP \[bu] 2
\f[B]name\f[R]: نام پنجره
.IP \[bu] 2
\f[B]desktop\f[R]: میزکار فعلی پنجره
.IP \[bu] 2
\f[B]all\f[R]: تمام موارد بالا
.PP
برای Wayland فهرست فیلدهای قابل قبول متفاوت است:
.IP \[bu] 2
\f[B]title\f[R]: عنوان پنجره
.IP \[bu] 2
\f[B]app\-id\f[R]: شناسه برنامه Wayland یا کلاس پنجره XWayland
.IP \[bu] 2
\f[B]class\f[R]: مشابه با app\-id
.IP \[bu] 2
\f[B]all\f[R]: تمام موارد بالا
.PP
پیش‌فرض: \f[I]all\f[R]
.RE
.TP
\f[B]\-matching\-negate\-char\f[R] \f[I]string\f[R]
تعیین نویسه مورد استفاده برای نقیض کردن عبارت جستجو (یعنی اگر با کلمه کلیدی بعدی تطبیق \f[B]نداشت\f[R]).
برای غیرفعال کردن روی `''` تنظیم کنید.
نخستین نویسه ASCII از رشته را در نظر می‌گیرد.
.RS
.PP
پیش‌فرض: `\-`
.RE
.SS "مرتب‌سازی منوی فیلترشده (Filtered menu sort)"
.TP
\f[B]\-[no]\-sort\f[R]
فعال یا غیرفعال کردن مرتب‌سازی برای منوی فیلترشده.
این تنظیم را می‌توان در زمان اجرا تغییر داد (به \f[B]\-kb\-toggle\-sort\f[R] مراجعه کنید).
.TP
\f[B]\-sorting\-method\f[R] `method` برای تعیین روش مرتب‌سازی.
۲ روش وجود دارد:
.RS
.IP \[bu] 2
\f[B]levenshtein\f[R] (پیش‌فرض)
.IP \[bu] 2
\f[B]fzf\f[R]
.RE
.SS "چیدمان و پوسته‌بندی (Layout and Theming)"
\f[B]مهم:\f[R] در نسخه‌های جدیدتر \f[B]rofi\f[R]، تمام گزینه‌های مربوط به پوسته
به فرمت جدید پوسته (theme format) منتقل شده‌اند.
آن‌ها دیگر گزینه‌های عادی \f[B]rofi\f[R] که بتوان مستقیماً در خط فرمان ارسال
کرد نیستند (زیرا تعداد آن‌ها بسیار زیاد است).
می‌توان قطعه‌کدهای کوچک را در خط فرمان ارسال کرد: \f[B]rofi \-theme\-str
\[aq]window {width: 50%;}\[aq]\f[R] تا یک تنظیم منفرد بازنویسی شود.
این قطعه‌کدها در پوسته فعلی ادغام می‌شوند.
همچنین می‌توان آن‌ها را به انتهای فایل کانفیگ \f[B]rofi\f[R] ضمیمه کرد تا
بخش‌هایی از پوسته بازنویسی شود.
.PP
بیشتر گزینه‌های زیر \f[B]منسوخ شده‌اند (deprecated)\f[R] و نباید استفاده شوند.
لطفاً برای سفارشی‌سازی \f[B]rofi\f[R] از فرمت جدید پوسته بهره بگیرید.
اطلاعات بیشتر درباره فرمت جدید را می‌توان در صفحه راهنمای
\f[B]rofi\-theme(5)\f[R] یافت.
.TP
\f[B]\-location\f[R]
تعیین محل قرارگیری پنجره.
اعداد به موقعیت‌های زیر بر روی صفحه مپ می‌شوند:
.RS
.IP
.EX
      1 2 3
      8 0 4
      7 6 5
.EE
.PP
پیش‌فرض: \f[I]0\f[R]
.RE
.TP
\f[B]\-fixed\-num\-lines\f[R]
حفظ تعداد ثابتی از خطوط قابل مشاهده.
.TP
\f[B]\-sidebar\-mode\f[R]
باز شدن در حالت نوار کناری (sidebar\-mode).
در این حالت، فهرستی از تمام حالت‌های فعال در پایین نمایش داده می‌شود (گزینه
\f[B]\-modes\f[R] را ببینید).
برای نمایش نوار کناری، دستور زیر را اجرا کنید:
.RS
.IP
.EX
    rofi \-show run \-sidebar\-mode
.EE
.RE
.TP
\f[B]\-hover\-select\f[R]
انتخاب خودکار گزینه‌ای که ماوس روی آن قرار می‌گیرد (hover).
این گزینه در ترکیب با کلیدهای سفارشی ماوس بهترین کاربرد را دارد.
برای استفاده از hover\-select و پذیرش یک گزینه با یک کلیک:
.RS
.IP
.EX
    rofi \-show run \-hover\-select \-me\-select\-entry \[aq]\[aq] \-me\-accept\-entry MousePrimary
.EE
.RE
.TP
\f[B]\-eh\f[R] \f[I]number\f[R]
تنظیم ارتفاع سطر (به نویسه). پیش‌فرض: \f[I]1\f[R]
.TP
\f[B]\-auto\-select\f[R]
هنگامی که تنها یک مدخل باقی مانده باشد، آن را به صورت خودکار انتخاب می‌کند.
.TP
\f[B]\-m\f[R] \f[I]num\f[R], \f[B]\-m\f[R] \f[I]name\f[R], \f[B]\-monitor\f[R] \f[I]num\f[R], \f[B]\-monitor\f[R] \f[I]name\f[R]
انتخاب مانیتور برای نمایش \f[B]rofi\f[R].
این گزینه به عنوان ورودی موارد زیر را می‌پذیرد: \f[I]primary\f[R] (اگر خروجی اصلی تنظیم شده باشد)، نام خروجی \f[I]xrandr\f[R]، یا یک عدد صحیح (به ترتیب شناسایی).
با اعداد منفی به گونه‌ای متفاوت رفتار می‌شود:
.RS
.IP \[bu] 2
\f[B]\-1\f[R]: مانیتور دارای فوکوس فعلی.
.IP \[bu] 2
\f[B]\-2\f[R]: پنجره دارای فوکوس فعلی (به این معنی که \f[B]rofi\f[R] روی پنجره دارای فوکوس نمایش داده می‌شود).
.IP \[bu] 2
\f[B]\-3\f[R]: موقعیت ماوس (تنظیمات مکان را لغو می‌کند تا رفتار عادی منوی متنی به دست آید).
.IP \[bu] 2
\f[B]\-4\f[R]: مانیتور حاوی پنجره دارای فوکوس.
.IP \[bu] 2
\f[B]\-5\f[R]: مانیتوری که اشاره‌گر ماوس را نشان می‌دهد.
.PP
پیش‌فرض: \f[I]\-5\f[R]
.PP
خروجی \f[B]rofi \-h\f[R] را برای مانیتورهای شناسایی‌شده، موقعیت و اندازه آن‌ها ببینید.
.RE
.TP
\f[B]\-theme\f[R] \f[I]filename\f[R]
مسیر فایل پوسته، یا نام یک پوسته نصب‌شده.
برای چگونگی حل و شناسایی پوسته‌ها صفحه راهنمای \f[B]rofi\-theme(5)\f[R] را ببینید.
.TP
\f[B]\-theme\-str\f[R] \f[I]string\f[R]
امکان تعیین بخش‌هایی از پوسته در خط فرمان به عنوان بازنویسی (override).
.RS
.PP
به عنوان مثال:
.IP
.EX
    rofi \-theme\-str \[aq]#window { fullscreen: true; }\[aq]
.EE
.PP
این گزینه را می‌توان چندین بار تعیین کرد.
این شیوه اکنون روش اصلی برای تنظیم پوسته از طریق خط فرمان است.
.RE
.TP
\f[B]\-dpi\f[R] \f[I]number\f[R]
بازنویسی تنظیمات پیش‌فرض DPI.
.RS
.PP
روی X11:
.IP \[bu] 2
اگر روی \f[B]0\f[R] تنظیم شود، تلاش می‌کند بر اساس اندازه صفحه X11 به صورت خودکار شناسایی کند (مشابه با i3 و GTK).
.IP \[bu] 2
اگر روی \f[B]1\f[R] تنظیم شود، تلاش می‌کند بر اساس اندازه مانیتوری که \f[B]rofi\f[R] روی آن نمایش داده می‌شود به صورت خودکار شناسایی کند (مشابه با جدیدترین نسخه Qt 5).
.PP
روی Wayland:
.IP \[bu] 2
اگر روی \f[B]0\f[R] یا \f[B]1\f[R] تنظیم شود، در صورت وجود یک مانیتور یا تعیین نام \f[B]\-monitor\f[R]، تلاش می‌کند به صورت خودکار شناسایی کند.
.RE
.TP
\f[B]\-selected\-row\f[R] \f[I]selected row\f[R]
انتخاب یک سطر مشخص.
.RS
.PP
پیش‌فرض: \f[I]0\f[R]
.RE
.SS "تنظیمات الگو (PATTERN setting)"
.TP
\f[B]\-terminal\f[R]
تعیین ترمینالی که باید راه‌اندازی شود.
.RS
.IP
.EX
    rofi \-terminal xterm
.EE
.PP
الگو: \f[I]{terminal}\f[R]
.PP
پیش‌فرض: \f[I]x\-terminal\-emulator\f[R]
.RE
.TP
\f[B]\-ssh\-client\f[R] \f[I]client\f[R]
بازنویسی کلاینت \f[B]ssh\f[R] مورد استفاده.
.RS
.PP
الگو: \f[I]{ssh\-client}\f[R]
.PP
پیش‌فرض: \f[I]ssh\f[R]
.RE
.SS "تنظیمات SSH (SSH settings)"
.TP
\f[B]\-ssh\-command\f[R] \f[I]cmd\f[R]
تنظیم دستوری که هنگام شروع یک نشست ssh اجرا می‌شود.
الگوی \f[I]{host}\f[R] با مدخل ssh انتخاب‌شده جایگزین می‌گردد.
.RS
.PP
الگو: \f[I]{ssh\-client}\f[R]
.PP
پیش‌فرض: \f[I]{terminal} \-e {ssh\-client} {host}\f[R]
.RE
.TP
\f[B]\-parse\-hosts\f[R]
تجزیه فایل \f[B]/etc/hosts\f[R] جهت استخراج مدخل‌ها.
.RS
.PP
پیش‌فرض: \f[I]disabled\f[R] (غیرفعال)
.RE
.TP
\f[B]\-[no\-]parse\-known\-hosts\f[R]
تجزیه فایل \f[B]\[ti]/.ssh/known_hosts\f[R] برای استخراج مدخل‌ها.
.RS
.PP
پیش‌فرض: \f[I]enabled\f[R] (فعال)
.RE
.SS "تنظیمات Run (Run settings)"
.TP
\f[B]\-run\-command\f[R] \f[I]cmd\f[R]
تنظیم دستور (\f[I]{cmd}\f[R]) برای اجرا هنگام راه‌اندازی یک برنامه.
بخش \f[I]PATTERN\f[R] را ببینید.
.RS
.PP
پیش‌فرض: \f[I]{cmd}\f[R]
.PP
مثال برای اجرای برنامه‌ها در یک cgroup اختصاصی با استفاده از systemd.
نیازمند یک پوسته است تا نام واحد (unit name) را به درستی اسکیپ و درون‌یابی کند.
.IP
.EX
\[dq]bash \-c \[aq]systemd\-run \-\-user \-\-unit=app\-rofi\-\[rs]$(systemd\-escape {cmd})\-\[rs]$RANDOM {cmd}\[aq]\[dq]
.EE
.RE
.TP
\f[B]\-run\-shell\-command\f[R] \f[I]cmd\f[R]
تنظیم دستور جهت اجرا هنگام راه‌اندازی یک برنامه درون پوسته (shell).
بخش \f[I]PATTERN\f[R] را ببینید.
.RS
.PP
پیش‌فرض: \f[I]{terminal} \-e {cmd}\f[R]
.RE
.TP
\f[B]\-run\-list\-command\f[R] \f[I]cmd\f[R]
در صورت تنظیم، از یک ابزار خارجی برای تولید فهرستی از دستورات قابل اجرا استفاده می‌کند.
از \f[B]run\-command\f[R] استفاده می‌نماید.
.RS
.PP
پیش‌فرض: \f[I]{cmd}\f[R]
.RE
.SS "تنظیمات جابه‌جاگر پنجره (Window switcher settings)"
.TP
\f[B]\-window\-format\f[R] \f[I]format\f[R]
قالب‌بندی آنچه برای پنجره‌ها نمایش داده می‌شود.
.RS
.PP
\f[I]format\f[R]: {field[:len]}
.PP
\f[I]field\f[R]:
.IP \[bu] 2
\f[B]w\f[R]: نام میزکار (desktop)
.IP \[bu] 2
\f[B]t\f[R]: عنوان پنجره
.IP \[bu] 2
\f[B]n\f[R]: نام
.IP \[bu] 2
\f[B]r\f[R]: نقش (role)
.IP \[bu] 2
\f[B]c\f[R]: کلاس
.PP
\f[I]len\f[R]: حداکثر طول فیلد (0 برای تنظیم خودکار اندازه).
اگر طول منفی باشد، مدخل بدون تغییر باقی خواهد ماند.
اگر طول مثبت باشد، مدخل کوتاه شده یا با فاصله خالی پر (pad) می‌شود تا به آن طول برسد.
.PP
پیش‌فرض: {w} {c} {t}
.RE
.TP
\f[B]\-window\-command\f[R] \f[I]cmd\f[R]
تنظیم دستور جهت اجرا روی پنجره انتخاب‌شده برای یک اقدام جایگزین (alt action)
(\f[B]\-kb\-accept\-alt\f[R]).
بخش \f[I]PATTERN\f[R] را ببینید.
.RS
.PP
پیش‌فرض: \f[I]\[lq]wmctrl \-i \-R {window}\[rq]\f[R]
.RE
.TP
\f[B]\-window\-thumbnail\f[R]
نمایش بندانگشتی پنجره (در صورت موجود بودن) به عنوان آیکون در جابه‌جاگر پنجره.
.RS
.PP
می‌توان مانع از خروج rofi هنگام بستن یک پنجره شد (که اجازه می‌دهد چندین پنجره پشت سر هم بسته شوند):
.IP
.EX
configuration {
  window {
      close\-on\-delete: false;
  }
}
.EE
.PP
می‌توان پنجره فعال فعلی را با تنظیم `hide\-active\-window' پنهان کرد:
.IP
.EX
configuration {
  window {
      hide\-active\-window: true;
  }
}
.EE
.PP
یا با ارسال \f[B]\-window\-hide\-active\-window true\f[R] در خط فرمان.
.PP
می‌توان با تنظیم `prefer\-icon\-theme' پوسته آیکون را نسبت به آیکون تنظیم‌شده پنجره در اولویت قرار داد:
.IP
.EX
configuration {
  window {
      prefer\-icon\-theme: true;
  }
}
.EE
.PP
یا با ارسال \f[B]\-window\-prefer\-icon\-theme true\f[R] در خط فرمان.
.RE
.SS "تنظیمات Combi (Combi settings)"
.TP
\f[B]\-combi\-modes\f[R] \f[I]mode1\f[R],\f[I]mode2\f[R]
حالت‌هایی که در حالت combi با یکدیگر ترکیب می‌شوند.
برای ساختار نحوی \f[B]\-combi\-modes\f[R] به \f[B]\-modes\f[R] مراجعه کنید.
برای به دست آوردن یک نمای ادغام‌شده از \f[B]window\f[R]، \f[B]run\f[R] و \f[B]ssh\f[R]:
.RS
.IP
.EX
    rofi \-show combi \-combi\-modes \[dq]window,run,ssh\[dq] \-modes combi
.EE
.PP
\f[B]نکته\f[R]: مدیر پنجره i3 در هنگام تعیین دستور exec با کاما سازگار نیست.
در این مورد، می‌توان از \f[B]#\f[R] به عنوان جداکننده استفاده کرد.
.RE
.TP
\f[B]\-combi\-display\-format\f[R]
رشته قالب‌بندی برای مدخل‌ها در دیالوگ \f[B]combi\f[R]:
.RS
.IP \[bu] 2
\f[B]mode\f[R]: نام نمایشی حالت
.IP \[bu] 2
\f[B]text\f[R]: متن مدخل
.PP
برای قالب‌بندی خروجی می‌توان از نشانه‌گذاری Pango استفاده کرد.
.PP
پیش‌فرض: {mode} {text}
.PP
نکته: در صورت فعال بودن \f[B]combi\-hide\-mode\-prefix\f[R]، این تنظیم نادیده گرفته می‌شود.
.RE
.SS "تاریخچه (History)"
.TP
\f[B]\-[no\-]disable\-history\f[R]
غیرفعال کردن یا فعال‌سازی مجدد تاریخچه.
.TP
\f[B]\-max\-history\-size\f[R] \f[I]number\f[R]
حداکثر تعداد مدخل‌ها برای ذخیره در تاریخچه.
پیش‌فرض 25 است.
(هشدار: تنظیم مقادیر بیش از حد بالا می‌تواند باعث افت سرعت شود)
.SS "دیالوگ پیام (Message dialog)"
.TP
\f[B]\-e\f[R] \f[I]message\f[R]
نمایش یک کادر محاوره‌ای پیام (به صورت داخلی برای نمایش خطاها استفاده می‌شود) حاوی \f[I]message\f[R].
پیام می‌تواند چندخطی باشد.
.RS
.PP
ارسال \f[B]\-e \-\f[R] به صورت مسدودکننده (blocking) از ورودی استاندارد می‌خواند و آن را نمایش می‌دهد.
.RE
.SS "تنظیمات مرورگر فایل (File browser settings)"
رفتار مرورگر فایل را می‌توان از طریق گزینه‌های زیر کنترل کرد:
.IP
.EX
configuration {
   filebrowser {
      \f[I]/** دایرکتوری شروع به کار مرورگر فایل */\f[R]
      directory: \[dq]/some/directory\[dq];
      \f[I]/**\f[R]
\f[I]        * روش مرتب‌سازی. می‌تواند به این مقادیر تنظیم شود:\f[R]
\f[I]        *   \- \[dq]name\[dq] (نام)\f[R]
\f[I]        *   \- \[dq]mtime\[dq] (زمان تغییر محتوا)\f[R]
\f[I]        *   \- \[dq]atime\[dq] (زمان دسترسی)\f[R]
\f[I]        *   \- \[dq]ctime\[dq] (زمان تغییر وضعیت)\f[R]
\f[I]        */\f[R]
      sorting\-method: \[dq]name\[dq];
      \f[I]/** دسته‌بندی دایرکتوری‌ها قبل از فایل‌ها */\f[R]
      directories\-first: true;
      \f[I]/** نمایش فایل‌های پنهان */\f[R]
      show\-hidden: false;
      \f[I]/** بازگرداندن ۱ هنگام لغو */\f[R]
      cancel\-returns\-1: true;
      \f[I]/** دستور اجرا */\f[R]
      command: \[dq]xdg\-open\[dq];
   }
}
.EE
.PP
این گزینه‌ها را می‌توان در خط فرمان نیز ارسال کرد، برای مثال:
.IP
.EX
rofi \-filebrowser\-cancel\-returns\-1 true \-show filebrowser
.EE
.PP
گزینه \f[B]show\-hidden\f[R] را می‌توان با کلید میانبر
\f[B]kb\-delete\-entry\f[R] نیز تغییر وضعیت داد.
.SS "تنظیمات مرورگر بازگشتی (Recursive Browser settings)"
رفتار مرورگر بازگشتی فایل را می‌توان با استفاده از گزینه‌های زیر کنترل کرد:
.IP
.EX
configuration {
   recursivebrowser {
      \f[I]/** دایرکتوری شروع به کار مرورگر فایل */\f[R]
      directory: \[dq]/some/directory\[dq];
      \f[I]/** بازگرداندن ۱ هنگام لغو */\f[R]
      cancel\-returns\-1: true;
      \f[I]/** فیلتر کردن مدخل‌ها با عبارت منظم */\f[R]
      filter\-regex: \[dq](.*cache.*|.*\[rs].o)\[dq];
      \f[I]/** دستور اجرا */\f[R]
      command: \[dq]xdg\-open\[dq];
   }
}
.EE
.SS "تاریخچه ورودی‌ها (Entry history)"
تعداد ورودی‌های پیشین برای کادر ورود متن را می‌توان با تنظیم max\-history روی جعبه ورودی تغییر داد.
.IP
.EX
configuration {
    entry  {
        max\-history: 30;
    }
}
.EE
.PP
به طور پیش‌فرض این فایل در دایرکتوری حافظه موقت (cache) سیستم، در فایلی به نام
\f[B]rofi\-entry\-history.txt\f[R] ذخیره می‌شود.
.SS "سایر موارد (Other)"
.TP
\f[B]\-drun\-use\-desktop\-cache\f[R]
ایجاد و استفاده از حافظه موقت (cache) برای محتوای فایل‌های desktop.
کاربردی برای سیستم‌های دارای دیسک‌های سخت کند.
.TP
\f[B]\-drun\-reload\-desktop\-cache\f[R]
در صورت فعال بودن \f[B]drun\-use\-desktop\-cache\f[R]، کش محتوای فایل‌های desktop را مجدداً بازسازی می‌کند.
.TP
\f[B]\-drun\-url\-launcher\f[R] \f[I]command\f[R]
دستور باز کردن مدخل Desktop که از نوع پیوند (Link) است.
.TP
\f[B]\-pid\f[R] \f[I]path\f[R]
وادار کردن \f[B]rofi\f[R] به ساخت فایل pid و بررسی آن هنگام راه‌اندازی.
فایل pid از اجرای همزمان چندین نمونه از \f[B]rofi\f[R] جلوگیری می‌کند.
این قابلیت هنگام اجرای \f[B]rofi\f[R] از طریق یک دیمن کلید میانبر بسیار مفید است.
.TP
\f[B]\-replace\f[R]
اگر rofi بر اساس فایل pid از قبل در حال اجرا باشد، تلاش می‌کند آن نمونه را متوقف سازد.
.TP
\f[B]\-display\-{mode}\f[R] \f[I]string\f[R]
تنظیم نام مورد استفاده برای mode.
این نام به عنوان اعلان (prompt) و در combi\-browser به کار می‌رود.
.RS
.PP
اکنون ترجیح بر استفاده از فایل پیکربندی است:
.IP
.EX
configuration {
  {mode} {
    display\-name: *string*;
  }
}
.EE
.RE
.TP
\f[B]\-[no\-]click\-to\-exit\f[R]
کلیک ماوس در خارج از پنجره \f[B]rofi\f[R] برای خروج.
.RS
.PP
پیش‌فرض: \f[I]enabled\f[R] (فعال)
.RE
.TP
\f[B]\-global\-kb\f[R] \f[B]\-no\-global\-kb\f[R]
(wayland) بازنویسی کلیدهای میانبر کامپوزیتور، تا \f[B]rofi\f[R] بتواند مجدداً از آن‌ها استفاده کند.
.RS
.PP
پیش‌فرض: \f[I]disabled\f[R] (غیرفعال)
.RE
.TP
\f[B]\-xserver\-i300\-workaround\f[R]
راهکار دور زدن اشکال در Xserver.
گزارش‌های شماره #611 و #1642 را در سامانه پیگیری اشکالات rofi ببینید.
.RS
.PP
پیش‌فرض: \f[I]disabled\f[R] (غیرفعال)
.RE
.SH "الگو (PATTERN)"
برای اجرای دستورات (به عنوان مثال، هنگام استفاده از اجراکننده ssh)، کاربر می‌تواند از خط فرمان استفاده‌شده بهره ببرد.
کلیدهای زیر را می‌توان استفاده کرد که در زمان اجرا جایگزین خواهند شد:
.IP \[bu] 2
\f[B]{host}\f[R]: میزبان مقصد برای برقراری اتصال
.IP \[bu] 2
\f[B]{terminal}\f[R]: ترمینال پیکربندی‌شده (به \-terminal مراجعه کنید)
.IP \[bu] 2
\f[B]{ssh\-client}\f[R]: کلاینت ssh پیکربندی‌شده (به \-ssh\-client مراجعه کنید)
.IP \[bu] 2
\f[B]{cmd}\f[R]: دستور قابل اجرا
.IP \[bu] 2
\f[B]{window}\f[R]: شناسه پنجره برای پنجره انتخاب‌شده (در \f[B]window\-command\f[R])
.PP
رشته به این صورت پردازش می‌شود: \f[B]{key}\f[R] با مقدار خود جایگزین می‌شود؛ اگر \f[B]{key}\f[R] تنظیم نشده باشد، حذف می‌گردد.
اگر \f[B]{key}\f[R] بین \f[B][]\f[R] قرار داشته باشد و \f[B]{key}\f[R] تنظیم نشده باشد، تمام متن بین \f[B][]\f[R] حذف می‌شود.
در غیر این صورت، کلید جایگزین شده و علامت‌های \f[B][]\f[R] برداشته می‌شوند.
.PP
به عنوان مثال: \f[B]{ssh\-client} [\-p {port}] {host}\f[R]
.SH "پوسته‌بندی (THEMING)"
لطفاً برای اطلاعات بیشتر درباره پوسته‌ها به صفحه راهنمای \f[B]rofi\-theme(5)\f[R] مراجعه فرمایید.
.SH "کلیدهای میانبر (KEY BINDINGS)"
لطفاً برای اطلاع از کلیدهای میانبر و چگونگی تنظیم آن‌ها، صفحه راهنمای \f[B]rofi\-keys(5)\f[R] را ببینید.
.PP
از کلیدهای میانبر می‌توان برای اقدامات (actions) نیز استفاده کرد؛ هنگامی که اقدام اجرا می‌شود، کلید مذکور فشرده می‌شود:
.SS "مهلت زمانی (Timeout)"
می‌توان اقدامی را پیکربندی کرد تا زمانی که rofi برای تعداد مشخصی ثانیه بدون تعامل باقی بماند، انجام پذیرد.
می‌توان یک میانبر کلیدی را برای فعال شدن پس از X ثانیه تعیین کرد.
.IP
.EX
configuration {
  timeout {
      delay:  15;
      action: \[dq]kb\-cancel\[dq];
  }
}
.EE
.SS "تغییر ورودی (Input change)"
هنگامی که ورودی جعبه متن تغییر کند:
.IP
.EX
configuration {
  inputchange {
      action: \[dq]kb\-row\-first\[dq];
  }
}
.EE
.SH "حالت‌های موجود (Available Modes)"
.SS window
نمایش فهرستی از تمام پنجره‌ها و امکان جابه‌جایی میان آن‌ها.
فشردن کلید میانبر \f[B]delete\-entry\f[R] (\f[B]shift\-delete\f[R]) پنجره را می‌بندد.
فشردن کلید میانبر \f[B]accept\-custom\f[R] (\f[B]control\-enter\f[R] یا \f[B]shift\-enter\f[R]) دستوری را روی پنجره اجرا می‌کند.
(گزینه \f[B]window\-command\f[R] را ببینید)؛
.PP
در صورت عدم وجود تطبیق، تلاش می‌کند ورودی را اجرا کند.
.SS windowcd
نمایش فهرستی از پنجره‌های موجود در میزکار فعلی و امکان جابه‌جایی میان آن‌ها.
فشردن میانبر \f[B]delete\-entry\f[R] (\f[B]shift\-delete\f[R]) پنجره را متوقف می‌سازد.
فشردن میانبر \f[B]accept\-custom\f[R] (\f[B]control\-enter\f[R] یا \f[B]shift\-enter\f[R]) دستوری را روی پنجره اجرا می‌کند.
(گزینه \f[B]window\-command\f[R] را ببینید)؛
.PP
در صورت نبود تطبیق، تلاش می‌کند متن ورودی را اجرا کند.
.SS run
فهرستی از فایل‌های اجرایی موجود در \f[B]$PATH\f[R] را نشان می‌دهد و می‌تواند آن‌ها را اجرا کند (اختیاری در ترمینال).
.IP \[bu] 2
فشردن میانبر \f[B]delete\-entry\f[R] (\f[B]shift\-delete\f[R]) این مدخل را از تاریخچه اجرا حذف می‌کند.
.IP \[bu] 2
فشردن میانبر \f[B]accept\-custom\f[R] (\f[B]control\-enter\f[R]) دستور را همان‌طور که در کادر ورودی وارد شده اجرا می‌کند.
.IP \[bu] 2
فشردن میانبر \f[B]accept\-alt\f[R] (\f[B]shift\-enter\f[R]) دستور را در یک ترمینال اجرا خواهد کرد.
.PP
با فشردن میانبر \f[B]mode\-complete\f[R] (\f[B]Control\-l\f[R])، می‌توانید از حالت File Browser برای اجرای برنامه همراه با یک فایل به عنوان نخستین آرگومان استفاده کنید.
.SS drun
مشابه با اجراکننده‌های \f[B]run\f[R] است، اما فهرست از فایل‌های دسکتاپ نصب‌شده ساخته می‌شود.
در صورت مشخص شدن در Desktop File، برنامه‌ها را به صورت خودکار در یک ترمینال اجرا می‌کند.
.IP \[bu] 2
فشردن میانبر \f[B]delete\-entry\f[R] (\f[B]shift\-delete\f[R]) این مدخل را از تاریخچه اجرا حذف می‌کند.
.IP \[bu] 2
فشردن میانبر \f[B]accept\-custom\f[R] (\f[B]control\-enter\f[R]) دستور را همان‌گونه که در کادر ورودی وارد شده اجرا می‌کند.
.IP \[bu] 2
فشردن میانبر \f[B]accept\-alt\f[R] (\f[B]shift\-enter\f[R]) دستور را در یک ترمینال اجرا می‌نماید.
.PP
با فشردن میانبر \f[B]mode\-complete\f[R] (\f[B]Control\-l\f[R])، می‌توانید در صورت تعیین در فایل دسکتاپ، از حالت File Browser برای اجرای برنامه همراه با ارسال یک فایل به عنوان آرگومان بهره ببرید.
.PP
حالت DRUN تلاش می‌کند از \c
.UR https://freedesktop.org/wiki/Specifications/desktop-entry-spec
مشخصات Desktop Entry در XDG
.UE \c
\ پیروی کند و باید با برنامه‌هایی که از این استاندارد استفاده می‌کنند سازگار باشد.
برخی برنامه‌ها فایل‌های دسکتاپ نامعتبر ایجاد می‌کنند؛ \f[B]rofi\f[R] این مدخل‌ها را کنار می‌گذارد.
برای اطلاعات بیشتر در مورد حالت DRUN به بخش اشکال‌زدایی مراجعه کنید که علت کنار گذاشته شدن فایل‌های دسکتاپ را چاپ می‌کند.
.PP
چند گزینه پیشرفته برای تنظیم دقیق این رفتار وجود دارد:
.IP
.EX
configuration {
   drun {
      \f[I]/** اسکن میزکار کاربر فعلی برای یافتن فایل‌های دسکتاپ */\f[R]
      scan\-desktop: true;
      \f[I]/** تجزیه فایل‌های دسکتاپ کاربر */\f[R]
      parse\-user:   true;
      \f[I]/** تجزیه فایل‌های دسکتاپ سیستمی */\f[R]
      parse\-system: false;
      \f[I]/** غیرفعال کردن DBusActivatable */\f[R]
      DBusActivatable: false;
   }
}
.EE
.SS ssh
فهرستی از مقاصد SSH را بر اساس فایل کانفیگ \f[B]ssh\f[R] شما نمایش می‌دهد و اجازه می‌دهد سریعاً به آن‌ها \f[B]ssh\f[R] بزنید.
.SS keys
فهرستی قابل جستجو از کلیدهای میانبر را نمایش می‌دهد.
.SS script
امکان افزودن حالت‌های سفارشی اسکریپت‌شده را فراهم می‌سازد؛ برای اطلاعات بیشتر صفحه راهنمای \f[B]rofi\-script(5)\f[R] را ببینید.
.SS combi
چندین حالت را در یک فهرست ترکیب می‌کند.
حالت‌های گنجانده‌شده را با گزینه \f[B]\-combi\-modes\f[R] مشخص کنید.
.PP
هنگام استفاده از حالت combi، می‌توان از \f[I]!bang\f[R] برای فیلتر کردن نتایج بر اساس حالت‌ها استفاده کرد.
تمام حالت‌هایی که با bang به عنوان پیشوند مطابقت داشته باشند گنجانده می‌شوند.
برای مثال فرض کنید گزینه \f[B]\-combi\-modes run,window,windowcd\f[R] را تعیین کرده‌اید.
اگر عبارت جستجوی شما با \f[B]!w\f[R] آغاز شود، تنها نتایج حالت‌های \f[B]window\f[R] و \f[B]windowcd\f[R] نمایش داده می‌شوند، حتی اگر ادامه متن ورودی با نتایج \f[B]run\f[R] مطابقت داشته باشد.
.PP
در صورت نبود تطبیق، ورودی توسط نخستین حالت ترکیب‌شده پردازش می‌شود.
.SH "پرسش‌های متداول (FAQ)"
.SS "متن در جابه‌جاگر پنجره به خوبی تراز نشده است"
استفاده از یک فونت با عرض یکسان (mono\-space) یا تب‌ها همراه با تنظیم tab\-stops را امتحان کنید.
.SS "پنجره کاملاً سیاه است"
نقل‌قول‌های استفاده‌شده در خط فرمان را بررسی کنید: ممکن است به جای \f[B]\[dq]\f[R] (نقل‌قول‌های استاندارد) از \f[B]\[lq]\f[R] (نقل‌قول‌های هوشمند) استفاده کرده باشید.
.SS "آیکون گوشه بالا سمت راست چه چیزی را نشان می‌دهد؟"
نشانگر موارد زیر را نمایش می‌دهد:
.IP \[bu] 2
\[ga]\[ga] غیرحساس به حروف بزرگ و کوچک و بدون مرتب‌سازی.
.IP \[bu] 2
\f[B]\-\f[R] حساسیت به حروف فعال، بدون مرتب‌سازی.
.IP \[bu] 2
\f[B]+\f[R] غیرحساس به حروف و مرتب‌سازی فعال.
.IP \[bu] 2
\f[B]±\f[R] مرتب‌سازی و حساسیت به حروف فعال.
.SS "چرا آیکون‌های متفاوتی برای حالت‌های run، drun و window می‌بینم"
هر یک از این حالت‌ها از روش‌های متفاوتی برای تعیین آیکون استفاده می‌کنند:
.IP \[bu] 2
Window: ابتدا از آیکونی که برنامه از طریق سرور X11 مشخص کرده استفاده می‌کند؛ اگر چیزی تنظیم نشده باشد، نام کلاس پنجره را در پوسته آیکون جستجو می‌کند.
.IP \[bu] 2
drun: از آیکون تعیین‌شده در فایل دسکتاپ بهره می‌برد.
.IP \[bu] 2
run: جستجو را با استفاده از نام فایل اجرایی انجام می‌دهد.
.SH "مثال‌ها (EXAMPLES)"
چند مثال کاربردی پایه از \f[B]rofi\f[R]:
.PP
نمایش دیالوگ run:
.IP
.EX
    rofi \-modes run \-show run
.EE
.PP
نمایش دیالوگ run، و امکان جابه‌جایی به دیالوگ فایل دسکتاپ (\f[B]drun\f[R]):
.IP
.EX
    rofi \-modes run,drun \-show run
.EE
.PP
ترکیب دیالوگ run و دیالوگ فایل دسکتاپ (\f[B]drun\f[R]):
.IP
.EX
    rofi \-modes combi \-show combi \-combi\-modes run,drun
.EE
.PP
ترکیب دیالوگ run و دیالوگ فایل دسکتاپ (\f[B]drun\f[R])، و امکان جابه‌جایی به جابه‌جاگر پنجره:
.IP
.EX
    rofi \-modes combi,window \-show combi \-combi\-modes run,drun
.EE
.PP
نمایش یک پیام متنی با این اعلان که این پایان کار است:
.IP
.EX
    rofi \-e \[dq]This is the end\[dq]
.EE
.PP
نمایش یک پیام متنی قرمز رنگ و بولد با این اعلان که هنوز پایان کار است:
.IP
.EX
    rofi \-e \[dq]<span color=\[aq]red\[aq]><b>This is still the end</b></span>\[dq] \-markup
.EE
.PP
نمایش تمامی کلیدهای میانبر:
.IP
.EX
    rofi \-show keys
.EE
.SH i3
در \c
.UR http://i3wm.org
i3
.UE \c
\ بهتر است اجرای \f[B]rofi\f[R] را به رها شدن کلید (key release) مقید کنید.
در غیر این صورت، نمی‌تواند صفحه‌کلید را تسخیر کند.
همچنین به \c
.UR http://i3wm.org/docs/userguide.html
راهنمای کاربری
.UE \c
\ در i3 مراجعه فرمایید:
.PP
برخی ابزارها (مانند \f[B]import\f[R] یا \f[B]xdotool\f[R]) ممکن است نتوانند هنگام رخداد KeyPress اجرا شوند، زیرا صفحه‌کلید/اشاره‌گر همچنان در تصرف است.
برای این موقعیت‌ها می‌توان از فلگ \f[B]\-\-release\f[R] استفاده کرد، زیرا دستور را پس از رها شدن کلیدها اجرا خواهد کرد.
.SH Hyprland
پویانمایی‌های Hyprland اجرای \f[B]Rofi\f[R] را کندتر از حد معمول جلوه می‌دهند.
برای جلوگیری از این حالت، قاعده زیر را به فایل hyprland.conf خود اضافه کنید:
.IP
.EX
layerrule = noanim,\[ha](rofi)$
.EE
.PP
این دستور پویانمایی‌ها را روی پنجره \f[B]Rofi\f[R] غیرفعال می‌کند.
.SH "مجوز (LICENSE)"
.IP
.EX
    MIT/X11

    Permission is hereby granted, free of charge, to any person obtaining
    a copy of this software and associated documentation files (the
    \[dq]Software\[dq]), to deal in the Software without restriction, including
    without limitation the rights to use, copy, modify, merge, publish,
    distribute, sublicense, and/or sell copies of the Software, and to
    permit persons to whom the Software is furnished to do so, subject to
    the following conditions:

    The above copyright notice and this permission notice shall be
    included in all copies or substantial portions of the Software.

    THE SOFTWARE IS PROVIDED \[dq]AS IS\[dq], WITHOUT WARRANTY OF ANY KIND, EXPRESS
    OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
    MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
    IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
    CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
    TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
    SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
.EE
.SH "وبگاه (WEBSITE)"
وبگاه \f[B]rofi\f[R] در \c
.UR https://github.com/davatorium/rofi
اینجا
.UE \c
\ در دسترس است.
.SH "پشتیبانی (SUPPORT)"
پشتیبانی \f[B]rofi\f[R] از راه‌های زیر امکان‌پذیر است:
.IP \[bu] 2
\c
.UR https://github.com/davatorium/rofi/discussions
گفتگوهای گیت‌هاب (GitHub Discussions)
.UE \c
.IP \[bu] 2
\c
.UR irc://irc.libera.chat:6697/#rofi
IRC
.UE \c
\ (کانال #rofi در irc.libera.chat)،
.SH "اشکال‌زدایی (DEBUGGING)"
برای اطلاعات بیشتر صفحه راهنمای \f[B]rofi\-debugging(5)\f[R] را ببینید.
.SH "سامانه گزارش باگ (ISSUE TRACKER)"
سامانه پیگیری باگ‌های \f[B]rofi\f[R] در \c
.UR https://github.com/davatorium/rofi/issues
اینجا
.UE \c
\ قابل مشاهده است.
پیش از ایجاد یک گزارش باگ، ابتدا ارسال پرسش در \c
.UR https://github.com/davatorium/rofi/discussions
انجمن گفتگو
.UE \c
\ را مد نظر قرار دهید.
هنگام ایجاد یک issue، لطفاً ابتدا \c
.UR https://github.com/davatorium/rofi/blob/master/.github/CONTRIBUTING.md
این سند
.UE \c
\ را مطالعه فرمایید.
.SH "همچنین ببینید (SEE ALSO)"
\f[B]rofi\-sensible\-terminal(1)\f[R], \f[B]dmenu(1)\f[R],
\f[B]rofi\-debugging(5)\f[R], \f[B]rofi\-theme(5)\f[R],
\f[B]rofi\-script(5)\f[R],
\f[B]rofi\-keys(5)\f[R],\f[B]rofi\-theme\-selector(1)\f[R],\f[B]rofi\-dmenu(5)\f[R]
.SH "نویسنده (AUTHOR)"
.IP \[bu] 2
Qball Cow \c
.MT qball@blame.services
.ME \c
.IP \[bu] 2
Rasmus Steinke \c
.MT rasi@xssn.at
.ME \c
.IP \[bu] 2
Morgane Glidic \c
.MT sardemff7+rofi@sardemff7.net
.ME \c
.PP
کد اصلی بر اساس کار توسعه داده شده توسط: \c
.UR https://github.com/seanpringle/simpleswitcher
Sean Pringle
.UE \c
\ \c
.MT sean.pringle@gmail.com
.ME \c
.PP
برای مشاهده فهرست کامل نویسندگان، فایل \f[B]AUTHORS\f[R] را بررسی کنید.