نام (NAME)

wofi - یک راه‌انداز برنامه الهام‌گرفته از rofi برای کامپوزیتورهای wlroots

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

wofi [گزینه‌ها]

توضیحات (DESCRIPTION)

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

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

گزینه‌ها (OPTIONS)

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

پیکربندی (CONFIGURATION)

برنامه wofi دارای ۳ فایل اصلی برای پیکربندی است. استفاده از همه این فایل‌ها کاملاً اختیاری است.

1.: فایل پیکربندی که پیش‌فرض آن ابتدا /usr/etc/wofi/config، سپس /etc/wofi/config و در نهایت $XDG_CONFIG_HOME/wofi/config است. این فایل‌ها به ترتیب و به‌صورت لایه‌ای بارگذاری می‌شوند که در آن هر یک بر روی مورد قبلی اعمال می‌گردد.
2.: فایل CSS که پیش‌فرض آن ابتدا /usr/etc/wofi/style.css، سپس /etc/wofi/style.css و در نهایت $XDG_CONFIG_HOME/wofi/style.css است. این فایل‌ها به ترتیب و به‌صورت لایه‌ای بارگذاری می‌شوند که در آن هر یک بر روی مورد قبلی اعمال می‌گردد.
3.: فایل رنگ‌ها که پیش‌فرض آن کَش pywal در $XDG_CACHE_HOME/wal/colors است.

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

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

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

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