wofi(1) General Commands Manual wofi(1) نام (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- است که در آن نام حالت است. اگر $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) قابل مشاهده است. wofi(1)