" Man page generated from reStructuredText
." by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\ \n[an-margin]
level \n[rst2man-indent-level]
level margin: \n[rst2man-indent\n[rst2man-indent-level]]
-
\n[rst2man-indent0]
\n[rst2man-indent1]
\n[rst2man-indent2]
..
.de1 INDENT
." .rstReportMargin pre:
. RS \
. nr rst2man-indent\n[rst2man-indent-level] \n[an-margin]
. nr rst2man-indent-level +1
." .rstReportMargin post:
..
.de UNINDENT
. RE
." indent \n[an-margin]
." old: \n[rst2man-indent\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
." new: \n[rst2man-indent\n[rst2man-indent-level]]
.in \n[rst2man-indent\n[rst2man-indent-level]]u
..
.TH "POLYBAR" "5" "Sep 01, 2026" "3.7.2" "راهنمای کاربر Polybar"
.SH "نام (NAME)"
polybar \- فایل پیکربندی برای polybar(1)
.SH "توضیحات (DESCRIPTION)"
.sp
فایل پیکربندی polybar رفتار و ظاهر polybar را تعیین می‌کند. این فایل از نوعی از قالب فایل INI بهره می‌برد. ساختار دقیق آن در زیر شرح داده شده است، اما ابتدا یک قطعه کد کوچک برای آشنایی با ساختار:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[section_name]
; یک توضیح
# توضیح دیگر

background = #ff992a
width = 90%
monitor = HDMI-0

screenchange-reload = false

; در صورت تمایل به حفظ فاصله‌های اطراف، از گیومه دوتایی استفاده کنید.
text = \(dq Some text \(dq
.EE
.UNINDENT
.UNINDENT
.sp
هنگام اجرا، \fBpolybar\fP فایل پیکربندی را به ترتیب زیر در یکی از چندین مکان جستجو خواهد کرد:
.INDENT 0.0
.IP \(bu 2
اگر آرگومان خط فرمان \fB\-c\fP یا \fB\-\-config\fP مشخص شده باشد، از مسیر ارائه‌شده استفاده می‌شود.
.IP \(bu 2
\fB/polybar/config\fP
.IP \(bu 2
\fB/polybar/config.ini\fP
.IP \(bu 2
\fB/home/ahoura/.config/polybar/config\fP
.IP \(bu 2
\fB/home/ahoura/.config/polybar/config.ini\fP
.IP \(bu 2
\fB/polybar/config.ini\fP
.IP \(bu 2
\fB/etc/xdg/polybar/config.ini\fP (تنها در صورتی که \fBXDG_CONFIG_DIRS\fP تنظیم نشده باشد)
.IP \(bu 2
\fB/etc/polybar/config.ini\fP
.UNINDENT
.SH "سینتکس (SYNTAX)"
.sp
کل پیکربندی مبتنی بر خط است، بنابراین همه‌چیز به یک خط منفرد محدود می‌شود. این بدان معناست که هیچ مقدار چندخطی یا ساختار چندخطی دیگری (به جز بخش‌ها) وجود ندارد.
هر خط دارای یکی از چهار نوع زیر است:
.INDENT 0.0
.IP \(bu 2
خالی (Empty)
.IP \(bu 2
توضیح (Comment)
.IP \(bu 2
سرآیند بخش (Section Header)
.IP \(bu 2
کلید (Key)
.UNINDENT
.sp
فاصله‌ها در ابتدا و انتهای هر خط نادیده گرفته می‌شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در این متن "فاصله‌ها" شامل نویسه فاصله معمولی و همچنین نویسه تب و هر نویسه دیگری است که \fBisspace(3)\fP برای آن مقدار \fBtrue\fP بازمی‌گرداند (مانند \fB\er\fP).
.UNINDENT
.UNINDENT
.sp
هر خطی که در یکی از این چهار نوع نگنجد، یک خطای نحوی است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
توصیه می‌شود نام‌های \fIسرآیند بخش\fP و نام‌های \fIکلید\fP تنها از نویسه‌های حرفی-عددی و همچنین خط تیره (\fB\-\fP)، زیرخط (\fB_\fP) و اسلش (\fB/\fP) استفاده کنند.
.sp
در عمل تمام نویسه‌ها مجاز هستند به جز فاصله‌ها و هر یک از این نویسه‌ها:
\fB\(dq\(aq=;#[](){}:.$\e%\fP
.UNINDENT
.UNINDENT
.SS "سرآیند بخش‌ها (Section Headers)"
.sp
بخش‌ها برای گروه‌بندی گزینه‌های پیکربندی در کنار هم استفاده می‌شوند. برای نمونه هر ماژول در بخش مربوط به خود تعریف می‌شود.
.sp
یک بخش با قرار دادن نام بخش در کروشه‌ها (\fB[\fP و \fB]\fP) تعریف می‌شود. برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[module/wm]
.EE
.UNINDENT
.UNINDENT
.sp
این کار بخشی با نام \fBmodule/wm\fP تعریف می‌کند و تمام کلیدهایی که پس از این خط تعریف شوند تا زمان اعلان بخش جدید، متعلق به این بخش خواهند بود.
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
نخستین خط غیرخالی و غیرتوضیحی در فایل اصلی کانفیگ باید یک سرآیند بخش باشد. این خط نمی‌تواند یک کلید باشد، چرا که آن کلید به هیچ بخشی تعلق نخواهد داشت.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
نام‌های بخش زیر رزرو شده‌اند و نمی‌توانند درون پیکربندی استفاده شوند:
\fBself\fP، \fBroot\fP و \fBBAR\fP&.
.UNINDENT
.UNINDENT
.SS "کلیدها (Keys)"
.sp
کلیدها با تخصیص یک مقدار به یک نام تعریف می‌شوند، مانند زیر:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
name = value
.EE
.UNINDENT
.UNINDENT
.sp
این دستور مقدار \fBvalue\fP را به کلید \fBname\fP در هر بخشی که این خط در آن قرار دارد تخصیص می‌دهد. نام‌های کلید در هر بخش باید یکتا باشند.
اگر مقدار توسط گیومه دوتایی (\fB\(dq\fP) محصور شده باشد، گیومه‌ها نادیده گرفته می‌شوند. بنابراین مورد زیر همچنان \fBvalue\fP را به \fBname\fP اختصاص می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
name = \(dqvalue\(dq
.EE
.UNINDENT
.UNINDENT
.sp
فاصله‌های اطراف علامت مساوی نادیده گرفته می‌شوند؛ موارد زیر همگی معادل هستند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
name=value
name = value
name =      value
.EE
.UNINDENT
.UNINDENT
.sp
از آنجا که فاصله‌ها در ابتدا و انتهای خط نیز نادیده گرفته می‌شوند، اگر می‌خواهید مقدار شما با یک فاصله آغاز یا پایان یابد، باید مقدار درون گیومه دوتایی قرار گیرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
name = \(dq value \(dq
.EE
.UNINDENT
.UNINDENT
.sp
در اینجا مقدار کلید \fBname\fP دارای فاصله خالی در ابتدا و انتها است.
.sp
برای رفتار با نویسه‌های دارای معنای خاص به صورت نویسه‌های معمولی، باید پیش از آن‌ها نویسه اسکیپ بک‌اسلش (\fB\e\fP) را قرار دهید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
name = \(dqvalue\e\evalue\e\evalue\(dq
.EE
.UNINDENT
.UNINDENT
.sp
مقدار این کلید \fBname\fP به \fBvalue\evalue\evalue\fP& منجر می‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
تنها نویسه‌ای که در حال حاضر دارای معنای خاص است، نویسه بک‌اسلش (\fB\e\fP) می‌باشد که به عنوان نویسه اسکیپ عمل می‌کند. موارد بیشتری در آینده اضافه خواهند شد.
.UNINDENT
.UNINDENT
.SS "خطوط خالی و توضیحات (Empty Lines & Comments)"
.sp
خطوط خالی و خطوط توضیحات هنگام خواندن فایل پیکربندی نادیده گرفته می‌شوند و بر رفتار polybar تأثیری ندارند. خطوط توضیحات با یکی از نویسه‌های \fB;\fP یا \fB#\fP آغاز می‌شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
توضیحات درون‌خطی (Inline comments) پشتیبانی نمی‌شوند. برای نمونه خط زیر با یک توضیح پایان نمی‌یابد؛ مقدار \fBname\fP در واقع روی \fBvalue ; comment\fP تنظیم می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
name = value ; comment
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
.nf
پروژه Polybar توسط Michael Carlberg ایجاد شد و در حال حاضر توسط Patrick Ziegler نگهداری می‌شود.
فهرست مشارکت‌کنندگان در گیت‌هاب در دسترس است.
.fi
.sp
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBpolybar\fP(1),
\fBpolybar\-msg\fP(1)
.SH "حق نشر (COPYRIGHT)"
2016-2026, Michael Carlberg & contributors
." End of generated man page.