.\" Generated by scdoc 1.11.5
.\" 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 "waybar\-sway\-workspaces" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar \- ماژول فضاهای کاری sway (sway workspaces module)
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول
\fBworkspaces\fR
فضاهای کاری در حال استفاده فعلی در Sway را نمایش می‌دهد.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
با نام
\fBsway/workspaces\fR
آدرس‌دهی می‌شود
.PP
\fBall\-outputs\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
در صورت تنظیم روی false، فضاهای کاری تنها روی همان خروجی (نمایشگری) که در آن قرار دارند نمایش داده می‌شوند.\& اگر روی true تنظیم شود، همه فضاهای کاری روی تمام خروجی‌ها نمایش داده خواهند شد.\&
.PP
\fBformat\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: {value}
.br
قالب نحوه نمایش اطلاعات.\&
.PP
\fBformat\-icons\fR:
.br
نوع: آرایه (array)
.br
بر اساس نام و وضعیت فضای کاری، آیکون متناظر انتخاب می‌شود.\& بخش \fBicons\fR را مشاهده کنید.\&
.PP
\fBdisable\-scroll\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
اگر روی false تنظیم شود، می‌توانید با پیمایش ماوس بین فضاهای کاری جابه‌جا شوید.\& اگر روی true تنظیم شود این رفتار غیرفعال می‌شود.\&
.PP
\fBreverse\-scroll\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
اگر روی false تنظیم شود، پیمایش به بالا به فضای کاری قبلی و پیمایش به پایین به فضای کاری بعدی سوئیچ می‌کند.\& اگر روی true تنظیم شود، این رفتار معکوس خواهد شد.\&
.PP
\fBdisable\-click\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
اگر روی false تنظیم شود، می‌توانید با کلیک کردن فضای کاری را تغییر دهید.\& اگر روی true تنظیم شود این رفتار غیرفعال می‌شود.\&
.PP
\fBsmooth\-scrolling\-threshold\fR:
.br
نوع: عدد اعشاری دقیق (double)
.br
آستانه مورد استفاده هنگام پیمایش.\&
.PP
\fBdisable\-scroll\-wraparound\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
اگر روی false تنظیم شود، پیمایش روی نشانگر فضای کاری پس از رسیدن به انتها به اولین فضای کاری برمی‌گردد و برعکس.\& اگر روی true تنظیم شود این رفتار غیرفعال می‌شود.\&
.PP
\fBenable\-bar\-scroll\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
اگر روی false تنظیم شود، نمی‌توانید با پیمایش روی کل نوار میان فضاهای کاری جابه‌جا شوید.\& اگر روی true تنظیم شود این رفتار فعال می‌شود.\&
.PP
\fBdisable\-markup\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
اگر روی true تنظیم شود، برچسب دکمه نشانه‌گذاری‌های pango را نادیده می‌گیرد (escape می‌کند).\&
.PP
\fBcurrent\-only\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
اگر روی true تنظیم شود، فقط فضاهای کاری دارای تمرکز (فوکوس) نمایش داده می‌شوند.\&
.PP
\fBpersistent\-workspaces\fR:
.br
نوع: json (پایین را ببینید)
.br
پیش‌فرض: خالی
.br
فضاهای کاری را فهرست می‌کند که همیشه باید نمایش داده شوند، حتی زمانی که وجود ندارند
.PP
\fBon\-update\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام به‌روزرسانی ماژول اجرا می‌شود.\&
.PP
\fBdisable\-auto\-back\-and\-forth\fR:
.br
نوع: بولی (bool)
.br
آیا هنگام کلیک روی فضاهای کاری قابلیت \fBworkspace_auto_back_and_forth\fR غیرفعال شود یا خیر.\& اگر این گزینه روی \fBtrue\fR تنظیم شود، کلیک روی فضای کاری که در حال حاضر در آن هستید هیچ کاری انجام نمی‌دهد، حتی اگر \fBworkspace_auto_back_and_forth\fR در پیکربندی Sway فعال باشد.\&
.PP
\fBalphabetical_sort\fR:
.br
نوع: بولی (bool)
.br
آیا فضاهای کاری به ترتیب الفبایی مرتب شوند یا خیر.\& لطفاً توجه داشته باشید که این ممکن است باعث شود دستور "swaymsg workspace prev/next" به فضاهایی ناسازگار با ترتیبی که در Waybar نشان داده شده حرکت کند.\&
.PP
warp\-on\-scroll:
.br
نوع: بولی (bool)
.br
پیش‌فرض: true
.br
اگر روی false تنظیم شود، می‌توانید بدون فعال بودن پرش اشاره‌گر ماوس (mouse warping) با پیمایش بین فضاهای کاری جابه‌جا شوید.\& اگر روی true تنظیم شود این رفتار غیرفعال می‌شود.\&
.PP
\fBwindow\-rewrite\fR:
.br
نوع: شیء (object)
.br
قواعد عبارات باقاعده (Regex) برای نگاشت کلاس پنجره به یک آیکون یا روش ترجیحی بازنمایی برای پنجره‌های یک فضای کاری.\&
.RS 4
کلیدها قواعد هستند، در حالی که مقادیر روش‌های بازنمایی می‌باشند.\&
قواعد می‌توانند `class<.\&.\&.\&>`، `title<.\&.\&.\&>`، یا هر دو را برای تطبیق دقیق‌تر مشخص کنند.\&
می‌توانید یک مقدار خالی به یک قاعده اختصاص دهید تا از تولید هرگونه بازنمایی در فضاهای کاری برای آن صرف‌نظر شود.\&
برای پنجره‌های Wayland ویژگی `class` با `app_id` تطبیق داده می‌شود، و برای پنجره‌های X11 با ویژگی `class` تطبیق داده می‌شود.\&
.PP
.RE
\fBwindow\-rewrite\-default\fR:
.RS 4
نوع: رشته (string)
.br
پیش‌فرض: "?\&"
.br
روش پیش‌فرض بازنمایی برای پنجره یک فضای کاری.\& این برای پنجره‌هایی استفاده می‌شود که کلاس آن‌ها با هیچ‌کدام از قواعد در \fBwindow\-rewrite\fR مطابقت ندارد.\&
.PP
.RE
\fBformat\-window\-separator\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: " "
.br
جداکننده‌ای که بین پنجره‌ها در یک فضای کاری استفاده می‌شود.\&
.PP
\fBexpand\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
به این ماژول امکان می‌دهد تا تمام فضای باقی‌مانده را به صورت پویا مصرف کند.\&
.PP
.PP
.SH "جایگزین‌های قالب (FORMAT REPLACEMENTS)"
.PP
\fB{value}\fR: نام فضای کاری، همان‌طور که توسط sway تعریف شده است.\&
.PP
\fB{name}\fR: شماره حذف‌شده از مقدار فضای کاری.\&
.PP
\fB{icon}\fR: آیکون، طبق تعریف در \fBformat\-icons\fR.\&
.PP
\fB{index}\fR: ایندکس فضای کاری.\&
.PP
\fB{output}\fR: خروجی که فضای کاری در آن قرار دارد.\&
.PP
\fB{windows}\fR: نتیجه حاصل از window\-rewrite
.PP
.SH "آیکون‌ها (ICONS)"
.PP
علاوه بر تطبیق نام فضای کاری، مقادیر زیر برای \fBformat\-icons\fR قابل تنظیم هستند.\&
.PP
.PD 0
.IP \(bu 4
\fBdefault\fR: زمانی نشان داده می‌شود که هیچ تطبیق رشته‌ای پیدا نشود.\&
.IP \(bu 4
\fBurgent\fR: زمانی نشان داده می‌شود که فضای کاری به عنوان اضطراری پرچم‌گذاری شده باشد
.IP \(bu 4
\fBfocused\fR: زمانی نشان داده می‌شود که فضای کاری دارای تمرکز باشد
.IP \(bu 4
\fBpersistent\fR: زمانی نشان داده می‌شود که فضای کاری دائمی باشد.\&
.IP \(bu 4
\fBhigh\-priority\-named\fR: آیکون‌های بر اساس نام همیشه برای این فضاهای کاری بدون در نظر گرفتن وضعیت نشان داده خواهند شد.\&
.PD
.PP
.SH "فضاهای کاری دائمی (PERSISTENT WORKSPACES)"
.PP
هر ورودی از \fBpersistent_workspace\fR نام فضای کاری را مشخص می‌کند که همیشه باید نشان داده شود.\&
همراه با این مقدار، فهرستی از خروجی‌ها است که نشان می‌دهد فضای کاری \fBکجا\fR باید نشان داده شود،
فهرست خالی نشان‌دهنده تمام خروجی‌ها است.\&
.PP
.nf
.RS 4
"sway/workspaces": {
	"persistent\-workspaces": {
		"3": [], // Always show a workspace with name '3', on all outputs if it does not exist
		"4": ["eDP\-1"], // Always show a workspace with name '4', on output 'eDP\-1' if it does not exist
		"5": ["eDP\-1", "DP\-2"] // Always show a workspace with name '5', on outputs 'eDP\-1' and 'DP\-2' if it does not exist
	}
}
.fi
.RE
.PP
نکته: فهرست خروجی‌ها می‌تواند از طریق خط فرمان با استفاده از \fBswaymsg \-t get_outputs\fR به دست آید.\&
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
"sway/workspaces": {
	"disable\-scroll": true,
	"all\-outputs": true,
	"format": "{name}: {icon}",
	"format\-icons": {
		"1": "",
		"2": "",
		"3": "",
		"4": "",
		"5": "",
		"high\-priority\-named": [ "1", "2" ],
		"urgent": "",
		"focused": "",
		"default": ""
	}
}
.fi
.RE
.PP
.nf
.RS 4
"sway/workspaces": {
  "format": "<span size='larger'>{name}</span> {windows}",
  "format\-window\-separator": " | ",
  "window\-rewrite\-default": "{name}",
  "window\-rewrite": {
    "class<firefox>": "",
    "class<kitty>": "k",
	"title<.* \- (.*) \- VSCodium>": "codium $1"  // captures part of the window title and formats it into output
  }
}
.fi
.RE
.PP
.SH "استایل (Style)"
.PP
.PD 0
.IP \(bu 4
\fB#workspaces button\fR
.IP \(bu 4
\fB#workspaces button.\&visible\fR
.IP \(bu 4
\fB#workspaces button.\&focused\fR
.IP \(bu 4
\fB#workspaces button.\&urgent\fR
.IP \(bu 4
\fB#workspaces button.\&persistent\fR
.IP \(bu 4
\fB#workspaces button.\&empty\fR
.IP \(bu 4
\fB#workspaces button.\&current_output\fR
.IP \(bu 4
\fB#workspaces button#sway\-workspace\-${name}\fR