.\" 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\-wlr\-workspaces" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar \- ماژول فضاهای کاری wlr (wlr workspaces module)
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول \fBworkspaces\fR فضاهای کاری در حال استفاده فعلی را در کامپوزیتور ویلند (wayland compositor) نمایش می‌دهد.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
با نام \fBext/workspaces\fR آدرس‌دهی می‌شود
.PP
\fBformat\fR:
.br
نوع: string
.br
پیش‌فرض: {name}
.br
قالب نحوه نمایش اطلاعات.\&
.PP
\fBformat\-icons\fR:
.br
نوع: array
.br
بر اساس نام و وضعیت فضای کاری، آیکون متناظر انتخاب می‌شود.\& بخش \fBآیکون‌ها (ICONS)\fR را ببینید.\&
.PP
\fBsort\-by\-name\fR:
.br
نوع: bool
.br
پیش‌فرض: true
.br
آیا فضاهای کاری بر اساس نام مرتب شوند یا خیر.\& در صورتی که همه نام‌ها عدد باشند، نام‌های فضاهای کاری به‌صورت عددی مرتب خواهند شد.\&
.PP
\fBsort\-by\-coordinates\fR:
.br
نوع: bool
.br
پیش‌فرض: false
.br
آیا فضاهای کاری بر اساس مختصات مرتب شوند یا خیر.\&
.br
توجه داشته باشید که اگر هر دو گزینه \fBsort\-by\-name\fR و \fBsort\-by\-coordinates\fR مقدار true داشته باشند، مرتب‌سازی بر اساس نام اولویت خواهد داشت.\& اگر هر دو false باشند، مرتب‌سازی بر اساس شناسه (id) انجام خواهد شد.\&
.PP
\fBsort\-by\-id\fR:
.br
نوع: bool
.br
پیش‌فرض: false
.br
آیا فضاهای کاری بر اساس شناسه (ID) مرتب شوند یا خیر.\& در صورتی که همه شناسه‌ها عدد باشند، شناسه‌های فضاهای کاری به‌صورت عددی مرتب خواهند شد.\& بر هر گزینه مرتب‌سازی دیگر اولویت دارد.\&
.PP
\fBall\-outputs\fR:
.br
نوع: bool
.br
پیش‌فرض: false
.br
اگر روی false تنظیم شود، گروه فضاهای کاری تنها در خروجی اختصاص‌یافته نشان داده خواهد شد.\& در غیر این صورت، همه گروه‌های فضاهای کاری نمایش داده می‌شوند.\&
.PP
\fBactive\-only\fR:
.br
نوع: bool
.br
پیش‌فرض: false
.br
اگر روی true تنظیم شود، تنها فضاهای کاری فعال یا اضطراری (urgent) نمایش داده خواهند شد.\&
.PP
\fBignore\-hidden\fR:
.br
نوع: bool
.br
پیش‌فرض: true
.br
اگر روی false تنظیم شود، فضاهای کاری پنهان نمایش داده خواهند شد.\&
.PP
.SH "جایگزین‌های قالب (FORMAT REPLACEMENTS)"
.PP
\fB{name}\fR: نام فضای کاری اختصاص‌یافته توسط کامپوزیتور.\&
.PP
\fB{id}\fR: شناسه (ID) فضای کاری اختصاص‌یافته توسط کامپوزیتور.\&
.PP
\fB{icon}\fR: آیکون، مطابق با آنچه در \fBformat\-icons\fR تعریف شده است.\&
.PP
.SH "عملیات‌های کلیک (CLICK ACTIONS)"
.PP
\fBactivate\fR: جابه‌جایی به فضای کاری.\&
.PP
\fBdeactivate\fR: غیرفعال‌سازی فضای کاری.\&
.PP
\fBclose\fR: بستن فضای کاری.\&
.PP
.SH "آیکون‌ها (ICONS)"
.PP
علاوه بر تطبیق با نام فضای کاری، موارد زیر را می‌توان در \fBformat\-icons\fR تنظیم کرد.\&
.PP
.PD 0
.IP \(bu 4
\fBdefault\fR: زمانی نشان داده می‌شود که هیچ تطبیق رشته‌ای پیدا نشود.\&
.IP \(bu 4
\fBactive\fR: زمانی نشان داده می‌شود که فضای کاری فعال باشد.\&
.PD
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
"ext/workspaces": {
	"format": "{name}: {icon}",
	"on\-click": "activate",
	"format\-icons": {
		"Workspace 1": "",
		"Workspace 2": "",
		"Workspace 3": "",
		"Workspace 4": "",
		"active": "",
		"default": ""
	},
	"sort\-by\-id": true
}
.fi
.RE
.PP
.SH "استایل (STYLE)"
.PP
.PD 0
.IP \(bu 4
\fB#workspaces\fR
.IP \(bu 4
\fB#workspaces button\fR
.IP \(bu 4
\fB#workspaces button.\&active\fR
.IP \(bu 4
\fB#workspaces button.\&urgent\fR
.IP \(bu 4
\fB#workspaces button.\&hidden\fR