| POWERLINE(1) | Powerline | POWERLINE(1) |
نام (NAME)
powerline - اسکریپت اعلان و نوار وضعیت Powerline.
خلاصه دستور (SYNOPSIS)
powerline EXT [SIDE] [-rMODULE] [-wWIDTH] [--last-exit-code=INT]
[--last-pipe-status=LIST] [--jobnum=INT]
[-cKEY.KEY=VALUE]… [-tTHEME.KEY.KEY=VALUE]… [-RKEY=VAL]…
[-pPATH]… [--socket=ADDRESS]
توضیحات (DESCRIPTION)
- EXT
- افزونه (Extension): برنامه‌ای که دستور powerline برای آن اجرا می‌شود (معمولاً shell یا tmux). همچنین از افزونه‌های wm. مانند wm.awesome پشتیبانی می‌کند.
- SIDE
- جهت (Side): مقادیر left و right به ترتیب نشان‌دهنده سمت چپ و راست هستند، above خطوطی را تولید می‌کند که قرار است درست بالای اعلان (prompt) چاپ شوند، و aboveleft مانند الحاق above با left است، با این استثنا که در این حالت تنها یک نمونه از پایتون استفاده می‌شود. ممکن است برای افزونه‌های wm.* نادیده گرفته شود.
- -r, --renderer-module MODULE
- ماژول رندرکننده (Renderer module). معمولاً مقداری مانند .bash یا .zsh (با نقطه در ابتدا) است که معادل powerline.renderers.{ext}{MODULE} می‌باشد؛ همچنین می‌تواند نام کامل ماژول باشد (در صورتی که یک ماژول سطح‌بالا باشد باید حداقل شامل یک نقطه باشد یا با یک نقطه پایان یابد) یا زیرماژول powerline.renderers (در حالتی که هیچ نقطه‌ای وجود نداشته باشد).
- -w, --width WIDTH
- حداکثر عرض اعلان. باعث کوتاه‌سازی و برش برخی از بخش‌ها (segments) می‌شود.
- --last-exit-code INT
- آخرین کد خروج.
- --last-pipe-status LIST
- مانند مورد بالا، اما باید حاوی آرایه‌ای از وضعیت‌ها باشد که با فاصله از هم جدا شده‌اند، و وضعیت خروج دستورها را در یک خط‌لوله (pipe) نشان می‌دهد.
- --jobnum INT
- تعداد کارها (jobs).
- -c, --config-override KEY.KEY=VALUE
- بازنویسی‌های پیکربندی برای config.json. این مقدار به یک دیکشنری تبدیل شده و با دیکشنری به‌دست‌آمده از پیکربندی واقعی JSON ادغام می‌شود: عبارت KEY.KEY=VALUE به {"KEY": {"KEY": VALUE}} ترجمه شده و سپس به‌صورت بازگشتی ادغام می‌گردد. VALUE می‌تواند هر مقدار معتبر JSON باشد؛ مقادیری که null، true، false نبوده و با رقم، { یا [ شروع نمی‌شوند، مانند رشته در نظر گرفته می‌شوند. در صورت حذف VALUE، کلید مربوطه پاک می‌شود.
- -t, --theme-override THEME.KEY.KEY=VALUE
- مانند مورد بالا، اما مختص به تم (پوسته). THEME باید به یک تم موجود و استفاده‌شده اشاره کند تا تأثیری داشته باشد، اگرچه استفاده از هر تمی در اینجا بلامانع است.
- -R, --renderer-arg KEY=VAL
- مانند مورد بالا، اما آرگومانی را برای رندرکننده فراهم می‌کند. این گزینه فقط باید توسط اتصالات پوسته (shell bindings) برای ارائه داده‌های گوناگونی مانند last-exit-code یا last-pipe-status استفاده شود (آن‌ها به دلایل تاریخی از --renderer-arg استفاده نمی‌کنند؛ زیرا --renderer-arg بعداً اضافه شد).
- -p, --config-path PATH
- مسیر به دایرکتوری پیکربندی. در صورت وجود، فایل‌های پیکربندی تنها در مسیر ارائه‌شده جستجو خواهند شد. می‌تواند چندین بار برای جستجو در فهرستی از دایرکتوری‌ها مشخص شود.
- --socket ADDRESS
- نشانی سوکت برای استفاده در کلاینت‌های دیمن (daemon). در گنو/لینوکس همیشه یک سوکت دامنه یونیکس (UNIX domain socket) و در Mac OS X یک سوکت فایلی است. در اینجا استفاده نمی‌شود و فقط برای سازگاری با سایر کلاینت‌های powerline وجود دارد. این آرگومان همیشه باید نخستین آرگومان باشد و به شکل --socket ADDRESS بیاید: استفاده از علامت = یا حالت کوتاه مجاز نیست (در سایر کلاینت‌های powerline، نه در اینجا).
- -h, --help
- نمایش راهنما و خروج.
نویسندگان (AUTHORS)
نوشته‌شده توسط Kim Silkebækken، Nikolay Pavlov، Kovid Goyal و مشارکت‌کنندگان. گلیف‌های موجود در font patcher توسط Fabrizio Schiavi ایجاد شده‌اند.
گزارش باگ‌ها (BUGS)
گزارش باگ‌های powerline به https://github.com/powerline/powerline/issues.
همچنین ببینید (SEE ALSO)
| December 23, 2025 | beta |