.Dd $Mdocdate: May 21 2023 $
.Dt WAYFIRE 1
.Os
.Sh "نام (NAME)"
.Nm wayfire
.Nd کامپوزیتور مدولار و گسترش‌پذیر Wayland
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm wayfire
.Op Fl c , -config Ar config_file
.Op Fl B , -config-backend Ar config_backend
.Op Fl d , -debug
.Op Fl D , -damage-debug
.Op Fl h , -help
.Op Fl R , -damage-renderer
.Op Fl v , -version
.Sh "توضیحات (DESCRIPTION)"
.Nm
یک کامپوزیتور Wayland با تمرکز بر مدولار بودن و گسترش‌پذیری است که با فراهم آوردن پیاده‌سازی هسته‌ای کوچک کار می‌کند و تمامی قابلیت‌های اصلی آن از طریق پلاگین‌ها ارائه می‌شوند.
پلاگین‌های پیش‌فرض، جلوه‌های سه‌بعدی شبیه به compiz مانند مکعب سه‌بعدی، پنجره‌های ژله‌ای، تاری، چشم‌ماهی و غیره را ارائه می‌دهند.
.Pp
گزینه‌های اختیاری به شرح زیر هستند:
.Pp
.Bl -tag -width Ds -compact
.It Fl c , -config Ar config_file
.Pp
اجرای
.Nm
با یک فایل پیکربندی جایگزین.
فایل پیکربندی پیش‌فرض ابتدا در متغیر محیطی
.Ev ${WAYFIRE_CONFIG_FILE}
یا مسیرهای
.Pa ${XDG_CONFIG_HOME}/wayfire/wayfire.ini ,
.Pa ${HOME}/.config/wayfire/wayfire.ini ,
.Pa ${XDG_CONFIG_HOME}/wayfire.ini ,
.Pa ${HOME}/.config/wayfire.ini .
جستجو می‌شود.
.Pp
.It Fl B , -config-backend Ar config_backend
.Pp
مشخص کردن بک‌اند پیکربندی مورد استفاده.
.Pp
.It Fl d , -debug
.Pp
فعال‌سازی ثبت گزارش‌های اشکال‌زدایی (debug logging).
.Pp
.It Fl D , -damage-debug
.Pp
فعال‌سازی اشکال‌زدایی اضافی برای نواحی آسیب‌دیده (damaged regions).
.Pp
.It Fl h , -help
.Pp
نمایش یک پیام راهنمای کوتاه.
.Pp
.It Fl R , -damage-renderer
.Pp
رندر مجدد نواحی آسیب‌دیده (damaged regions).
.Pp
.It Fl v , -version
.Pp
نمایش نسخه برنامه.
.El
.Sh "محیط (ENVIRONMENT)"
.Nm
متغیرهای محیطی زیر را در نظر می‌گیرد:
.Pp
.Bl -tag -width Ds -compact
.It Ev WAYFIRE_CONFIG_FILE
فایل پیکربندی مورد استفاده.
.Pp
.It Ev WAYFIRE_PLUGIN_XML_PATH
.Pp
رشته‌ای از مسیرها که با : از یکدیگر جدا شده‌اند و برای یافتن فایل‌های پیکربندی پلاگین‌ها جستجو می‌شوند.
به صورت پیش‌فرض
.Nm
به دنبال فایل‌های پیکربندی در
.Pa /usr/share/wayfire/metadata
و
.Pa ${XDG_DATA_HOME}/wayfire/metadata
می‌گردد.
.Pp
.It Ev WAYFIRE_PLUGIN_PATH
.Pp
رشته‌ای از مسیرها که با : از یکدیگر جدا شده‌اند و برای یافتن پلاگین‌ها جستجو می‌شوند.
به صورت پیش‌فرض
.Nm
به دنبال پلاگین‌ها در
.Pa /usr/lib/wayfire
و
.Pa ${XDG_DATA_HOME}/wayfire/plugins
می‌گردد.
.Pp
.It Ev _WAYFIRE_SOCKET
.Pp
جایگزینی سوکت برای برقراری ارتباط با یک نمونه مشخص از
.Nm
از طریق IPC.
در صورت اجرای هم‌زمان چندین نمونه از
.Nm
کاربرد دارد.
.El
.Pp
علاوه بر این،
.Nm
متغیرهای محیطی زیر را نیز تنظیم می‌کند:
.Pp
.Bl -tag -width Ds -compact
.It Ev WAYFIRE_SOCKET
.Pp
سوکتی که هنگام ارتباط با
.Nm
استفاده می‌شود.
.Pp
.It Ev WAYLAND_DISPLAY
.Pp
نمایشگر فعال فعلی Wayland.
.Pp
.It Ev CONFIG_FILE_ENV
.Pp
مشخص می‌کند کدام فایل پیکربندی در حال استفاده است.
.Pp
.It Ev _JAVA_AWT_WM_NONREPARENTING
.Pp
برای پنجره‌های مبتنی بر java مورد نیاز است و روی 1 تنظیم می‌شود.
.Pp
.It Ev DISPLAY
.It Ev XCURSOR_SIZE
.It Ev XCURSOR_THEME
.Pp
متغیرهایی برای استفاده در پنجره‌های موروثی
.Xr xwayland 1 .
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr xwayland 1