نام (NAME)

river - کامپوزیتور غیریکپارچه برای Wayland

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

river [گزینه‌ها]

توضیحات (DESCRIPTION)

برنامهٔ River یک کامپوزیتور غیریکپارچه (non-monolithic) برای Wayland است؛ این برنامه کامپوزیتور و مدیر پنجره را در یک برنامه ترکیب نمی‌کند. در عوض، کاربران می‌توانند هر مدیر پنجره‌ای را که پروتکل river-window-management-v1 را پیاده‌سازی کرده باشد انتخاب کنند.

این بدان معناست که river بدون یک مدیر پنجرهٔ سازگار قابل استفاده نیست. فهرستی از مدیرهای پنجرهٔ سازگار را می‌توان در ویکی river یافت: https://codeberg.org/river/wiki/src/branch/main/pages/wm-list.md

گزینه‌ها (OPTIONS)

-h

-version

-c shell_command

-log-level [error|warning|info|debug]

-no-xwayland

کلیدهای میانبر (KEYBINDINGS)

کلیدهای میانبر زیر همیشه فعال هستند:

Ctrl+Alt+F1 - Ctrl+Alt+F12

مدیرهای پنجره می‌توانند کلیدهای میانبر دیگری اضافه کنند، اما نمی‌توانند این کلیدهای میانبر توکار را لغو یا بازنویسی کنند.

پیکربندی (CONFIGURATION)

هنگام راه‌اندازی، river در صورت وجود فایلی اجرایی در مسیر $XDG_CONFIG_HOME/river/init آن را اجرا خواهد کرد. اگر $XDG_CONFIG_HOME تنظیم نشده باشد، مسیر ~/.config/river/init به‌جای آن استفاده خواهد شد.

فایل اجرایی init پس از مقداردهی اولیهٔ سرور Wayland مربوط به river اما پیش از ورود به حلقهٔ اصلی (main loop)، به‌عنوان رهبر گروه فرآیند (process group leader) اجرا می‌شود. هنگام خروج، river سیگنال SIGTERM را به این گروه فرآیند ارسال خواهد کرد.

معمولاً این فایل اجرایی یک اسکریپت شل است که مدیر پنجرهٔ کاربر و سایر برنامه‌های طولانی‌مدت را اجرا می‌کند. برای مثال، می‌توان kanshi(1) را برای مدیریت پیکربندی خروجی نمایشگر اجرا کرد.

نویسندگان (AUTHORS)

نگهداری‌شده توسط Isaac Freund <mail@isaacfreund.com> با همراهی مشارکت‌کنندگان متن‌باز. برای اطلاعات بیشتر دربارهٔ توسعهٔ river، https://isaacfreund.com/software/river را ببینید.