.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.3 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\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 \\$1
. 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 "POWERLINE" "1" "Dec 23, 2025" "beta" "Powerline"
.SH "نام (NAME)"
powerline \- اسکریپت اعلان و نوار وضعیت Powerline.
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\fBpowerline\fP \fIEXT\fP [\fISIDE\fP] [\fB\-r\fP\fIMODULE\fP] [\fB\-w\fP\fIWIDTH\fP] [\fB\-\-last\-exit\-code\fP=\fIINT\fP]
          [\fB\-\-last\-pipe\-status\fP=\fILIST\fP] [\fB\-\-jobnum\fP=\fIINT\fP]
          [\fB\-c\fP\fIKEY.KEY=VALUE\fP]… [\fB\-t\fP\fITHEME.KEY.KEY=VALUE\fP]… [\fB\-R\fP\fIKEY=VAL\fP]…
          [\fB\-p\fP\fIPATH\fP]… [\fB\-\-socket\fP=\fIADDRESS\fP]
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.INDENT 0.0
.TP
.B \fIEXT\fP
افزونه (Extension): برنامه‌ای که دستور powerline برای آن اجرا می‌شود (معمولاً \fBshell\fP یا \fBtmux\fP). همچنین از افزونه‌های \fBwm.\fP مانند \fBwm.awesome\fP\& پشتیبانی می‌کند.
.TP
.B \fISIDE\fP
جهت (Side): مقادیر \fBleft\fP و \fBright\fP به ترتیب نشان‌دهنده سمت چپ و راست هستند، \fBabove\fP خطوطی را تولید می‌کند که قرار است درست بالای اعلان (prompt) چاپ شوند، و \fBaboveleft\fP مانند الحاق \fBabove\fP با \fBleft\fP است، با این استثنا که در این حالت تنها یک نمونه از پایتون استفاده می‌شود. ممکن است برای افزونه‌های \fBwm.*\fP نادیده گرفته شود.
.TP
\fB\-r\fP, \fB\-\-renderer\-module\fP \fIMODULE\fP
ماژول رندرکننده (Renderer module). معمولاً مقداری مانند \fB\&.bash\fP یا \fB\&.zsh\fP (با نقطه در ابتدا) است که معادل \fBpowerline.renderers.{ext}{MODULE}\fP می‌باشد؛ همچنین می‌تواند نام کامل ماژول باشد (در صورتی که یک ماژول سطح‌بالا باشد باید حداقل شامل یک نقطه باشد یا با یک نقطه پایان یابد) یا زیرماژول \fBpowerline.renderers\fP (در حالتی که هیچ نقطه‌ای وجود نداشته باشد).
.TP
\fB\-w\fP, \fB\-\-width\fP \fIWIDTH\fP
حداکثر عرض اعلان. باعث کوتاه‌سازی و برش برخی از بخش‌ها (segments) می‌شود.
.TP
\fB\-\-last\-exit\-code\fP \fIINT\fP
آخرین کد خروج.
.TP
\fB\-\-last\-pipe\-status\fP \fILIST\fP
مانند مورد بالا، اما باید حاوی آرایه‌ای از وضعیت‌ها باشد که با فاصله از هم جدا شده‌اند، و وضعیت خروج دستورها را در یک خط‌لوله (pipe) نشان می‌دهد.
.TP
\fB\-\-jobnum\fP \fIINT\fP
تعداد کارها (jobs).
.TP
\fB\-c\fP, \fB\-\-config\-override\fP \fIKEY.KEY=VALUE\fP
بازنویسی‌های پیکربندی برای \fBconfig.json\fP\&. این مقدار به یک دیکشنری تبدیل شده و با دیکشنری به‌دست‌آمده از پیکربندی واقعی JSON ادغام می‌شود: عبارت KEY.KEY=VALUE به \fB{\(dqKEY\(dq: {\(dqKEY\(dq: VALUE}}\fP ترجمه شده و سپس به‌صورت بازگشتی ادغام می‌گردد. VALUE می‌تواند هر مقدار معتبر JSON باشد؛ مقادیری که \fBnull\fP، \fBtrue\fP، \fBfalse\fP نبوده و با رقم، \fB{\fP یا \fB[\fP شروع نمی‌شوند، مانند رشته در نظر گرفته می‌شوند. در صورت حذف VALUE، کلید مربوطه پاک می‌شود.
.TP
\fB\-t\fP, \fB\-\-theme\-override\fP \fITHEME.KEY.KEY=VALUE\fP
مانند مورد بالا، اما مختص به تم (پوسته). THEME باید به یک تم موجود و استفاده‌شده اشاره کند تا تأثیری داشته باشد، اگرچه استفاده از هر تمی در اینجا بلامانع است.
.TP
\fB\-R\fP, \fB\-\-renderer\-arg\fP \fIKEY=VAL\fP
مانند مورد بالا، اما آرگومانی را برای رندرکننده فراهم می‌کند. این گزینه فقط باید توسط اتصالات پوسته (shell bindings) برای ارائه داده‌های گوناگونی مانند last\-exit\-code یا last\-pipe\-status استفاده شود (آن‌ها به دلایل تاریخی از \fB\-\-renderer\-arg\fP استفاده نمی‌کنند؛ زیرا \fB\-\-renderer\-arg\fP بعداً اضافه شد).
.TP
\fB\-p\fP, \fB\-\-config\-path\fP \fIPATH\fP
مسیر به دایرکتوری پیکربندی. در صورت وجود، فایل‌های پیکربندی تنها در مسیر ارائه‌شده جستجو خواهند شد. می‌تواند چندین بار برای جستجو در فهرستی از دایرکتوری‌ها مشخص شود.
.TP
\fB\-\-socket\fP \fIADDRESS\fP
نشانی سوکت برای استفاده در کلاینت‌های دیمن (daemon). در گنو/لینوکس همیشه یک سوکت دامنه یونیکس (UNIX domain socket) و در Mac OS X یک سوکت فایلی است. در اینجا استفاده نمی‌شود و فقط برای سازگاری با سایر کلاینت‌های powerline وجود دارد. این آرگومان همیشه باید نخستین آرگومان باشد و به شکل \fB\-\-socket ADDRESS\fP بیاید: استفاده از علامت \fB=\fP یا حالت کوتاه مجاز نیست (در سایر کلاینت‌های powerline، نه در اینجا).
.TP
\fB\-h\fP, \fB\-\-help\fP
نمایش راهنما و خروج.
.UNINDENT
.SH "نویسندگان (AUTHORS)"
.sp
نوشته‌شده توسط Kim Silkebækken، Nikolay Pavlov، Kovid Goyal و مشارکت‌کنندگان. گلیف‌های موجود در font patcher توسط Fabrizio Schiavi ایجاد شده‌اند.
.SH "گزارش باگ‌ها (BUGS)"
.sp
گزارش باگ‌های powerline به \%<https://\:github\:.com/\:powerline/\:powerline/\:issues>\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBpowerline\-daemon(1)\fP, \fBpowerline\-config(1)\fP
.\" End of generated man page.