.TH wofi 1
.SH "نام (NAME)"
wofi \- یک راه‌انداز برنامه الهام‌گرفته از rofi برای کامپوزیتورهای wlroots

.SH "خلاصه دستور (SYNOPSIS)"
.B wofi
[گزینه‌ها]

.SH "توضیحات (DESCRIPTION)"
.B wofi
یک برنامه منو الهام‌گرفته از rofi برای کامپوزیتورهای wlroots مانند sway است. هدف آن ارائه قابلیت سفارشی‌سازی و انعطاف‌پذیری بالا به کمک استایل‌دهی CSS و یک حالت dmenu با قابلیت بی‌پایان اسکریپت‌نویسی است. wofi می‌تواند به‌طور خودکار بدون کَش در حالت dmenu با فراخوانی آن به‌عنوان dmenu از طریق یک پیوند نمادین (symlink) اجرا شود.

wofi به‌طور ویژه برای wlroots طراحی شده و از پروتکل wlr\-layer\-shell استفاده می‌کند. اگر کامپوزیتور شما از این پروتکل پشتیبانی نمی‌کند یا در محیطی غیر از wayland هستید، wofi باید با \fB\-\-normal\-window\fR اجرا شود، در غیر این صورت متوقف خواهد شد (crash خواهد کرد). اگر مایلید wofi را به این شیوه اجرا کنید، می‌توانید \fBnormal_window=true\fR را نیز در فایل پیکربندی خود قرار دهید تا نیازی به تعیین این گزینه در خط فرمان نباشد.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-h, \-\-help
پیام راهنما را چاپ کرده و خارج می‌شود.
.TP
.B \-f, \-\-fork
منو را در پس‌زمینه اجرا (fork) می‌کند تا ترمینال اجراکننده آن بتواند بسته شود.
.TP
.B \-c, \-\-conf=\fIPATH\fR
فایل پیکربندی مورد استفاده را مشخص می‌کند.
.TP
.B \-s, \-\-style=\fIPATH\fR
فایل CSS مورد استفاده به‌عنوان شیوه‌نامه (stylesheet) را مشخص می‌کند.
.TP
.B \-C, \-\-color=\fIPATH\fR
فایل رنگ‌های مورد استفاده را مشخص می‌کند.
.TP
.B \-d, \-\-dmenu
برنامه wofi را در حالت dmenu اجرا می‌کند.
.TP
.B \-S, \-\-show=\fIMODE\fR
حالتی که برنامه در آن اجرا می‌شود را مشخص می‌کند. فهرستی از حالت‌ها در \fBwofi\fR(7) آورده شده است.
.TP
.B \-W, \-\-width=\fIWIDTH\fR
پهنای منو را بر حسب پیکسل یا درصدی از اندازه صفحه نمایش مشخص می‌کند؛ پیش‌فرض 50% است. پیکسل استفاده می‌شود مگر اینکه مقدار به % ختم شود.
.TP
.B \-H, \-\-height=\fIHEIGHT\fR
ارتفاع منو را بر حسب پیکسل یا درصدی از اندازه صفحه نمایش مشخص می‌کند؛ پیش‌فرض 40% است. پیکسل استفاده می‌شود مگر اینکه مقدار به % ختم شود.
.TP
.B \-p, \-\-prompt=\fIPROMPT\fR
متن اعلانی که در جعبه جستجو نمایش داده می‌شود را تنظیم می‌کند؛ پیش‌فرض نام حالت است.
.TP
.B \-x, \-\-xoffset=\fIOFFSET\fR
انحراف افقی (x) از موقعیت مکانی را بر حسب پیکسل مشخص می‌کند؛ پیش‌فرض 0 است.
.TP
.B \-y, \-\-yoffset=\fIOFFSET\fR
انحراف عمودی (y) از موقعیت مکانی را بر حسب پیکسل مشخص می‌کند؛ پیش‌فرض 0 است.
.TP
.B \-n, \-\-normal\-window
برنامه wofi را به جای استفاده از wlr\-layer\-shell در یک پنجره معمولی اجرا می‌کند.
.TP
.B \-I, \-\-allow\-images
اجازه می‌دهد دنباله‌های گریز تصویر پردازش و نمایش داده شوند.
.TP
.B \-m, \-\-allow\-markup
اجازه می‌دهد نشانه‌گذاری‌های pango پردازش و نمایش داده شوند.
.TP
.B \-k, \-\-cache\-file=\fIPATH\fR
فایل کَش را برای بارگذاری/ذخیره حافظه پنهان مشخص می‌کند؛ پیش‌فرض $XDG_CACHE_HOME/wofi\-<mode name> است که در آن <mode name> نام حالت است. اگر $XDG_CACHE_HOME مشخص نشده باشد از ~/.cache استفاده می‌شود.
.TP
.B \-t, \-\-term=\fITERM\fR
ترمینال مورد استفاده هنگام اجرای یک برنامه در خط فرمان را تعیین می‌کند. این گزینه ترتیب اجرای پیش‌فرض ترمینال‌ها را که به‌ترتیب kitty، alacritty، wezterm، foot، termite، gnome\-terminal و weston\-terminal است بازنویسی می‌کند.
.TP
.B \-P, \-\-password \fR[character]
برنامه wofi را در حالت رمز عبور اجرا می‌کند که می‌توان در آن یک نویسه اختیاری برای نمایش رمز تعیین کرد. در صورت عدم تعیین نویسه، به‌طور پیش‌فرض از * استفاده می‌شود.
.TP
.B \-e, \-\-exec\-search
فعال‌سازی جستجو با کلید enter خود عبارت مورد جستجو را اجرا می‌کند، نه اولین نتیجه را.
.TP
.B \-E, \-\-no\-custom\-entry
فقط ورودی‌ها به حالت‌ها ارسال می‌شوند، هرگز محتوای جعبه جستجو ارسال نخواهد شد.
.TP
.B \-b, \-\-hide\-scroll
نوارهای پیمایش را پنهان می‌کند.
.TP
.B \-M, \-\-matching=\fIMODE\fR
حالت تطبیق را مشخص می‌کند که می‌تواند یکی از مقادیر contains، strict-contains، multi-contains یا fuzzy باشد؛ پیش‌فرض contains است.
.TP
.B \-i, \-\-insensitive
جستجوی غیرحساس به بزرگی و کوچکی حروف را فعال می‌کند.
.TP
.B \-q, \-\-parse\-search
دنباله‌های گریز تصویر و نشانه‌گذاری‌های pango را حذف می‌کند تا از استفاده آن‌ها در جستجو جلوگیری شود.
.TP
.B \-v, \-\-version
نسخه برنامه را چاپ کرده و خارج می‌شود.
.TP
.B \-l, \-\-location=\fILOCATION\fR
موقعیت مکانی را مشخص می‌کند. برای اطلاعات بیشتر \fBwofi\fR(7) را ببینید؛ پیش‌فرض center است.
.TP
.B \-a, \-\-no\-actions
کنش‌های چندگانه را برای حالت‌هایی که از آن پشتیبانی می‌کنند غیرفعال می‌کند.
.TP
.B \-D, \-\-define=\fIKEY=VALUE\fR
یک گزینه پیکربندی را تنظیم می‌کند.
.TP
.B \-L, \-\-lines=\fILINES\fR
ارتفاع را به‌جای پیکسل بر حسب تعداد خطوط مشخص می‌کند.
.TP
.B \-w, \-\-columns=\fICOLUMNS\fR
تعداد ستون‌ها را برای نمایش مشخص می‌کند؛ پیش‌فرض 1 است.
.TP
.B \-O, \-\-sort\-order=\fIORDER\fR
ترتیب مرتب‌سازی پیش‌فرض را تعیین می‌کند. در حال حاضر دو ترتیب default و alphabetical وجود دارد. برای جزئیات \fBwofi\fR(7) را ببینید.
.TP
.B \-G, \-\-gtk\-dark
به wofi دستور می‌دهد در صورت موجود بودن، از نوع تیره (dark variant) پوسته فعلی GTK استفاده کند.
.TP
.B \-Q, \-\-search
موردی را برای جستجوی فوری به هنگام باز شدن مشخص می‌کند.
.TP
.B \-o, \-\-monitor
نمایشگری که برنامه روی آن باز می‌شود را تعیین می‌کند.
.TP
.B \-r, \-\-pre\-display\-cmd
در صورت تنظیم، ورودی قابل‌انتخاب همان‌طور که هست نمایش داده نمی‌شود، بلکه بر اساس خروجی این دستور (که می‌تواند هر چیزی باشد) نمایش داده خواهد شد. پیشنهاد می‌شود از این گزینه همراه با \fB"echo %s | some_cmd"\fR یا \fB"some_cmd %s"\fR استفاده شود، زیرا رشته به روشی مشابه printf جایگزین می‌شود. این گزینه بر خروجی wofi پس از انجام انتخاب تأثیری نخواهد داشت و به شما امکان می‌دهد چیزی به‌جز خروجی اولیه را نمایش دهید.
.TP
.B \-j, \-\-hide\-search
نوار جستجو را پنهان می‌کند.

.SH "پیکربندی (CONFIGURATION)"
برنامه wofi دارای ۳ فایل اصلی برای پیکربندی است. استفاده از همه این فایل‌ها کاملاً اختیاری است.
.IP 1. 4
فایل پیکربندی که پیش‌فرض آن ابتدا /usr/etc/wofi/config، سپس /etc/wofi/config و در نهایت $XDG_CONFIG_HOME/wofi/config است. این فایل‌ها به ترتیب و به‌صورت لایه‌ای بارگذاری می‌شوند که در آن هر یک بر روی مورد قبلی اعمال می‌گردد.
.IP 2. 4
فایل CSS که پیش‌فرض آن ابتدا /usr/etc/wofi/style.css، سپس /etc/wofi/style.css و در نهایت $XDG_CONFIG_HOME/wofi/style.css است. این فایل‌ها به ترتیب و به‌صورت لایه‌ای بارگذاری می‌شوند که در آن هر یک بر روی مورد قبلی اعمال می‌گردد.
.IP 3. 4
فایل رنگ‌ها که پیش‌فرض آن کَش pywal در $XDG_CACHE_HOME/wal/colors است.

.P
هر ۳ مسیر را می‌توان به‌صورت دستی با استفاده از پرچم مربوطه در خط فرمان مشخص کرد. در مورد دو فایل آخر، می‌توان آن‌ها را علاوه بر خط فرمان در فایل پیکربندی نیز مشخص کرد.

هنگامی که مسیرها به‌صورت دستی تعیین شوند، هیچ موردی از مسیر $XDG_CONFIG_HOME بارگذاری نمی‌شود؛ هرچند فایل‌های سراسری سیستم همچنان ابتدا بارگذاری خواهند شد.

در صورتی که $XDG_CONFIG_HOME تعیین نشده باشد، مقدار پیش‌فرض آن ~/.config خواهد بود، و به همین ترتیب اگر $XDG_CACHE_HOME تعیین نشده باشد، مقدار پیش‌فرض آن ~/.cache است.

اطلاعات مربوط به قالب این فایل‌ها در
.B wofi\fR(5)
قابل مشاهده است.