.\" Generated by scdoc 1.11.4
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "sway" "1" "2026-06-23"
.PP
.SH "نام (NAME)"
.PP
sway \- یک کامپوزیتور Wayland سازگار با i3
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBsway\fR [options.\&.\&.\&] [command]
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-h, --help\fR
.RS 4
نمایش پیام راهنما و خروج.\&
.PP
.RE
\fB-c, --config\fR <config>
.RS 4
یک فایل پیکربندی را مشخص می‌کند.\&
.PP
.RE
\fB-C, --validate\fR
.RS 4
بررسی معتبر بودن فایل پیکربندی و سپس خروج.\&
.PP
.RE
\fB-d, --debug\fR
.RS 4
فعال‌سازی ثبت وقایع کامل، شامل اطلاعات دیباگ.\&
.PP
.RE
\fB-v, --version\fR
.RS 4
نمایش شماره نسخه و خروج.\&
.PP
.RE
\fB-V, --verbose\fR
.RS 4
فعال‌سازی ثبت وقایع با جزئیات بیشتر (verbose).\&
.PP
.RE
\fB--get-socketpath\fR
.RS 4
مسیر سوکت IPC را دریافت و چاپ کرده، سپس خارج می‌شود.\&
.PP
.RE
.SH "توضیحات (DESCRIPTION)"
.PP
دستور sway برای برطرف کردن نیاز به یک مدیر پنجره شبیه به i3 برای Wayland ایجاد شد.\&
توسعه‌دهندگان بالادستی i3 قصدی برای پورت کردن i3 به Wayland ندارند، و پروژه‌های
پیشنهادی دیگران نیز ناتمام رها شدند (vaporware شدند).\& سپاس فراوان از تیم i3
برای ارائه چنین نرم‌افزار فوق‌العاده‌ای؛ آن‌قدر عالی که کاربران شما ترجیح می‌دهند
یک مدیر پنجره کاملاً جدید را از ابتدا بنویسند که \fIدقیقاً\fR مانند i3 رفتار کند،
تا اینکه به چیز دیگری مهاجرت کنند.\&
.PP
شما می‌توانید sway را مستقیماً از طریق یک tty یا به‌وسیله یک مدیر ورود (login manager) سازگار با Wayland اجرا کنید.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
دستور sway به ترتیب در مسیرهای زیر به دنبال یک فایل پیکربندی می‌گردد:
.PP
.PD 0
.IP 1. 4
\(ti/.\&sway/config
.IP 2. 4
$XDG_CONFIG_HOME/sway/config (مسیر پیشنهادی)
.IP 3. 4
\(ti/.\&i3/config
.IP 4. 4
$XDG_CONFIG_HOME/i3/config
.IP 5. 4
/etc/sway/config
.IP 6. 4
/etc/i3/config
.PD
.PP
در صورت عدم تنظیم، مقدار پیش‌فرض $XDG_CONFIG_HOME برابر با \fB\(ti/.\&config\fR خواهد بود.\&
.PP
اگر هیچ فایل پیکربندی یافت نشود، یک خطا رخ می‌دهد.\& پیکربندی پیش‌فرضِ توصیه‌شده
معمولاً در \fB/etc/sway/config\fR نصب می‌شود؛ توصیه می‌شود این فایل را در
\fB\(ti/.\&config/sway/config\fR کپی کرده و آن را ویرایش نمایید.\&
.PP
برای اطلاعات بیشتر در مورد قالب فایل پیکربندی، \fBsway\fR(5) را ببینید.\&
.PP
.SH "دستورهای IPC (IPC COMMANDS)"
.PP
اگرچه عموماً استفاده از \fBswaymsg\fR(1) ترجیح داده می‌شود، اما می‌توانید دستور
\fBsway\fR \fIcommand\fR را اجرا کنید تا \fIcommand\fR به نمونه در حال اجرای sway
ارسال شود.\& همچنین می‌توانید با \fBi3-msg\fR(1) یا حتی \fBi3\fR(1) دستورها را ارسال کنید.\&
.PP
.SH "محیط (ENVIRONMENT)"
.PP
متغیرهای محیطی زیر بر sway تأثیر می‌گذارند:
.PP
\fISWAYSOCK\fR
.RS 4
مسیر سوکت IPC برنامه sway را مشخص می‌کند.\&
.PP
.RE
\fIXKB_DEFAULT_RULES\fR, \fIXKB_DEFAULT_MODEL\fR, \fIXKB_DEFAULT_LAYOUT\fR,
\fIXKB_DEFAULT_VARIANT\fR, \fIXKB_DEFAULT_OPTIONS\fR
.RS 4
تنظیمات صفحه‌کلید xkb را پیکربندی می‌کند.\& \fBxkeyboard-config\fR(7) را ببینید.\& روش
ترجیحی برای پیکربندی صفحه‌کلید از طریق فایل پیکربندی است؛
\fBsway-input\fR(5) را ببینید.\&
.PP
.RE
متغیرهای محیطی زیر توسط sway مقداردهی می‌شوند:
.PP
\fIDISPLAY\fR
.RS 4
در صورت کامپایل با پشتیبانی از Xwayland و در صورتی که Xwayland توسط پیکربندی
غیرفعال نشده باشد، با نام نمایشگر X مورد استفاده برای Xwayland مقداردهی می‌شود.\&
.PP
.RE
\fII3SOCK\fR
.RS 4
برای سازگاری با i3، مسیر سوکت IPC برنامه sway را مشخص می‌کند.\&
.PP
.RE
\fISWAYSOCK\fR
.RS 4
مسیر سوکت IPC برنامه sway را مشخص می‌کند.\&
.PP
.RE
\fIWAYLAND_DISPLAY\fR
.RS 4
نام نمایشگر Wayland که sway روی آن در حال اجرا است را مشخص می‌کند.\&
.PP
.RE
\fIXCURSOR_SIZE\fR
.RS 4
اندازه پیکربندی‌شده مکان‌نما را مشخص می‌کند.\&
.PP
.RE
\fIXCURSOR_THEME\fR
.RS 4
تم پیکربندی‌شده مکان‌نما را مشخص می‌کند.\&
.PP
.RE
.SH "نویسندگان (AUTHORS)"
.PP
نگهداری‌شده توسط Simon Ser <contact@emersion.\&fr>، با همراهی سایر مشارکت‌کنندگان
متن‌باز.\& برای کسب اطلاعات بیشتر در رابطه با توسعه sway، نشانی
<https://github.\&com/swaywm/sway> را ببینید.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsway\fR(5) \fBswaymsg\fR(1) \fBsway-input\fR(5) \fBsway-output\fR(5) \fBsway-bar\fR(5)
\fBsway-ipc\fR(7)