.\" 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\-taskbar" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar \- ماژول نوار وظیفه wlr (wlr taskbar module)
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول \fBtaskbar\fR برنامه‌های در حال حاضر باز را نمایش می‌دهد.\& این ماژول نیازمند
یک کامپوزیتور است که رابط foreign\-toplevel\-manager را پیاده‌سازی کرده باشد.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
با نام \fBwlr/taskbar\fR آدرس‌دهی می‌شود
.PP
\fBall\-outputs\fR:
.br
نوع: bool
.br
پیش‌فرض: false
.br
اگر روی false تنظیم شود، برنامه‌های موجود در خروجی فعلی waybar نمایش داده می‌شوند.\& در غیر این صورت، همه برنامه‌ها نشان داده خواهند شد.\&
.PP
\fBformat\fR:
.br
نوع: string
.br
پیش‌فرض: {icon}
.br
قالب نحوه نمایش اطلاعات.\&
.PP
\fBicon\-theme\fR:
.br
نوع: array|string
.br
نام‌های تم‌های آیکون که باید برای یافتن یک آیکون استفاده شوند.\& فهرست از چپ به راست پیمایش خواهد شد.\& در صورت تعیین نشدن، پیش‌فرض سیستم استفاده خواهد شد.\&
.PP
\fBicon\-size\fR:
.br
نوع: integer
.br
پیش‌فرض: 16
.br
اندازه آیکون.\&
.PP
\fBmarkup\fR:
.br
نوع: bool
.br
پیش‌فرض: false
.br
اگر روی true تنظیم شود، نشانه‌گذاری پانگو (pango markup) در format و tooltip\-format پذیرفته می‌شود.\&
.PP
\fBtooltip\fR:
.br
نوع: bool
.br
پیش‌فرض: true
.br
اگر روی false تنظیم شود، هیچ تول‌تیپی نمایش داده نخواهد شد.\&
.PP
\fBtooltip\-format\fR:
.br
نوع: string
.br
پیش‌فرض: {title}
.br
قالب نحوه نمایش اطلاعات در تول‌تیپ.\&
.PP
\fBactive\-first\fR:
.br
نوع: bool
.br
پیش‌فرض: false
.br
اگر روی true تنظیم شود، همیشه وظایف در نوار وظیفه به‌گونه‌ای مرتب می‌شوند که برنامه فعال فعلی اول باشد.\& در غیر این صورت مرتب‌سازی مجدد انجام نمی‌شود.\&
.PP
\fBsort\-by\-app\-id\fR:
.br
نوع: bool
.br
پیش‌فرض: false
.br
اگر روی true تنظیم شود، وظایف بر اساس app_id خود گروه‌بندی می‌شوند.\& نمی‌تواند همراه با '\&active\-first'\& استفاده شود.\&
.PP
\fBon\-click\fR:
.br
نوع: string
.br
عملیاتی که باید هنگام کلیک با کلید چپ ماوس روی دکمه برنامه اجرا شود.\&
.PP
\fBon\-click\-middle\fR:
.br
نوع: string
.br
عملیاتی که باید هنگام کلیک با کلید میانی ماوس روی دکمه برنامه اجرا شود.\&
.PP
\fBon\-click\-right\fR:
.br
نوع: string
.br
عملیاتی که باید هنگام کلیک با کلید راست ماوس روی دکمه برنامه اجرا شود.\&
.PP
\fBon\-update\fR:
.br
نوع: string
.br
دستوری که هنگام به‌روزرسانی ماژول اجرا می‌شود.\&
.PP
\fBignore\-list\fR:
.br
نوع: array
.br
فهرستی از app_idها/عنوان‌ها که باید پنهان باشند.\&
.PP
\fBapp_ids\-mapping\fR:
.br
نوع: object
.br
دیکشنری از app_id برای جایگزینی.\&
.PP
\fBrewrite\fR:
.br
نوع: object
.br
قوانین بازنویسی قالب خروجی ماژول.\& بخش \fBقوانین بازنویسی (REWRITE RULES)\fR را ببینید.\&
.PP
.SH "جایگزین‌های قالب (FORMAT REPLACEMENTS)"
.PP
\fB{icon}\fR: آیکون برنامه.\&
.PP
\fB{name}\fR: نام برنامه مطابق با فایل desktop در صورتی که فایل desktop مناسب یافت شود، در غیر این صورت مشابه {app_id} است.\&
.PP
\fB{title}\fR: عنوان برنامه.\&
.PP
\fB{app_id}\fR: شناسه برنامه (app_id == نام برنامه).\&
.PP
\fB{state}\fR: وضعیت برنامه (minimized، maximized، active، fullscreen).\&
.PP
\fB{short_state}\fR: وضعیت برنامه (minimize == m، maximized == M، active == A، fullscreen == F) که به‌صورت یک کاراکتر نمایش داده می‌شود.\&
.PP
.SH "عملیات‌های کلیک (CLICK ACTIONS)"
.PP
\fBactivate\fR: آوردن برنامه به پیش‌زمینه.\&
.PP
\fBminimize\fR: تغییر وضعیت کمینه‌سازی برنامه.\&
.PP
\fBminimize\-raise\fR: آوردن برنامه به پیش‌زمینه یا تغییر وضعیت کمینه‌سازی آن.\&
.PP
\fBmaximize\fR: تغییر وضعیت بیشینه‌سازی برنامه.\&
.PP
\fBfullscreen\fR: تغییر وضعیت تمام‌صفحه برنامه.\&
.PP
\fBclose\fR: بستن برنامه.\&
.PP
.SH "قوانین بازنویسی (REWRITE RULES)"
.PP
گزینه \fBrewrite\fR یک شیء است که در آن کلیدها عبارت‌های منظم (regex) و مقادیر قوانین بازنویسی در صورت تطابق عبارت هستند.\& قوانین می‌توانند شامل ارجاع به بخش‌های منطبق‌شده (captures) عبارت باشند.\&
.PP
عبارات منظم و جایگزینی از قوانین ECMA\-script پیروی می‌کنند.\&
.PP
اگر هیچ عبارتی مطابقت نداشته باشد، قالب خروجی بدون تغییر باقی می‌ماند.\&
.PP
عبارت‌های نامعتبر (مانند پرانتزهای جفت‌نشده) نادیده گرفته می‌شوند.\&
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
"wlr/taskbar": {
	"format": "{icon}",
	"icon\-size": 14,
	"icon\-theme": "Numix\-Circle",
	"tooltip\-format": "{title}",
	"on\-click": "activate",
	"on\-click\-middle": "close",
	"ignore\-list": [
	    "Alacritty"
	],
	"app_ids\-mapping": {
		"firefoxdeveloperedition": "firefox\-developer\-edition"
	},
	"rewrite": {
		"Firefox Web Browser": "Firefox",
		"Foot Server": "Terminal"
	}
}
.fi
.RE
.PP
.SH "استایل (STYLE)"
.PP
.PD 0
.IP \(bu 4
\fB#taskbar\fR
.IP \(bu 4
\fB#taskbar button\fR
.IP \(bu 4
\fB#taskbar button.\&maximized\fR
.IP \(bu 4
\fB#taskbar button.\&minimized\fR
.IP \(bu 4
\fB#taskbar button.\&active\fR
.IP \(bu 4
\fB#taskbar button.\&fullscreen\fR