.\" 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\-network" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar\-network \- ماژول شبکه در waybar
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول \fBnetwork\fR اطلاعات مربوط به اتصالات شبکه جاری را نمایش می‌دهد.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
مخاطب با \fBnetwork\fR
.PP
\fBinterface\fR:
.br
typeof: string
.br
استفاده از رابط تعریف‌شده به‌جای تشخیص خودکار.\& کاراکترهای عمومی (wildcard) را می‌پذیرد.\&
.PP
\fBrfkill\fR:
.br
typeof: bool
.br
default: true
.br
در صورت فعال بودن، زمانی که rfkill رابط‌های wlan را مسدود کرده باشد، قالب \fBdisabled\fR استفاده خواهد شد.\&
.PP
\fBinterval\fR:
.br
typeof: integer
.br
default: 60
.br
فاصله زمانی که اطلاعات شبکه دریافت می‌شود (مثلاً قدرت سیگنال).\&
.PP
\fBfamily\fR:
.br
typeof: string
.br
default: \fBipv4\fR
.br
خانواده آدرسی که برای جایگزینی قالب {ipaddr} و تعیین وجود اتصال شبکه استفاده می‌شود.\& برای نمایش هر دو، آن را روی ipv4_6 تنظیم کنید.\&
.PP
\fBformat\fR:
.br
typeof: string
.br
default: \fB{ifname}\fR
.br
قالب، نحوه نمایش اطلاعات.\& این قالب زمانی استفاده می‌شود که قالب‌های دیگر مشخص نشده باشند.\&
.PP
\fBformat\-ethernet\fR:
.br
typeof: string
.br
این قالب زمانی استفاده می‌شود که یک رابط اترنت نمایش داده شود.\&
.PP
\fBformat\-wifi\fR:
.br
typeof: string
.br
این قالب زمانی استفاده می‌شود که یک رابط بی‌سیم نمایش داده شود.\&
.PP
\fBformat\-linked\fR:
.br
typeof: string
.br
این قالب زمانی استفاده می‌شود که یک رابط متصل بدون آدرس IP نمایش داده شود.\&
.PP
\fBformat\-disconnected\fR:
.br
typeof: string
.br
این قالب زمانی استفاده می‌شود که رابط نمایش‌داده‌شده قطع باشد.\&
.PP
\fBformat\-disabled\fR:
.br
typeof: string
.br
این قالب زمانی استفاده می‌شود که rfkill رابط‌های wlan را مسدود کرده باشد.\&
.PP
\fBformat\-icons\fR:
.br
typeof: array/object
.br
بر اساس قدرت سیگنال فعلی، نماد مربوطه انتخاب می‌شود.\&
.br
ترتیب از \fBکم\fR به \fBزیاد\fR است.\& یا در صورتی که یک شیء باشد بر اساس وضعیت.\&
.PP
\fBrotate\fR:
.br
typeof: integer
.br
مقدار مثبت برای چرخاندن برچسب متنی (با گام‌های ۹۰ درجه).\&
.PP
\fBmax\-length\fR:
.br
typeof: integer
.br
حداکثر طول برحسب کاراکتر که ماژول باید نمایش دهد.\&
.PP
\fBmin\-length\fR:
.br
typeof: integer
.br
حداقل طول برحسب کاراکتر که ماژول باید بپذیرد.\&
.PP
\fBalign\fR:
.br
typeof: float
.br
تراز برچسب درون ماژول، که در آن ۰ چپ‌چین و ۱ راست‌چین است.\& اگر ماژول چرخانده شود، از جهت جریان متن پیروی خواهد کرد.\&
.PP
\fBjustify\fR:
.br
typeof: string
.br
تراز متن درون برچسب ماژول، که گزینه‌های '\&left'\&، '\&right'\& یا '\&center'\& را برای تعیین موقعیت امکان‌پذیر می‌سازد.\&
.PP
\fBon\-click\fR:
.br
typeof: string
.br
دستوری که هنگام کلیک روی ماژول اجرا می‌شود.\&
.PP
\fBon\-click\-middle\fR:
.br
typeof: string
.br
دستوری که هنگام کلیک وسط روی ماژول با استفاده از چرخ ماوس اجرا می‌شود.\&
.PP
\fBon\-click\-right\fR:
.br
typeof: string
.br
دستوری که هنگام کلیک راست روی ماژول اجرا می‌شود.\&
.PP
\fBon\-update\fR:
.br
typeof: string
.br
دستوری که هنگام به‌روزرسانی ماژول اجرا می‌شود.\&
.PP
\fBon\-scroll\-up\fR:
.br
typeof: string
.br
دستوری که هنگام پیمایش رو به بالا روی ماژول اجرا می‌شود.\&
.PP
\fBon\-scroll\-down\fR:
.br
typeof: string
.br
دستوری که هنگام پیمایش رو به پایین روی ماژول اجرا می‌شود.\&
.PP
\fBsmooth\-scrolling\-threshold\fR:
.br
typeof: double
.br
آستانه‌ای که هنگام پیمایش استفاده می‌شود.\&
.PP
\fBtooltip\fR:
.br
typeof: bool
.br
default: \fBtrue\fR
.br
گزینه‌ای برای غیرفعال کردن راهنمای شناور هنگام قرار گرفتن نشانگر ماوس روی آن.\&
.PP
\fBtooltip\-format\fR:
.br
typeof: string
.br
قالب، نحوه نمایش اطلاعات در راهنمای شناور.\& این قالب زمانی استفاده می‌شود که قالب‌های دیگر مشخص نشده باشند.\&
.PP
\fBtooltip\-format\-ethernet\fR:
.br
typeof: string
.br
این قالب زمانی استفاده می‌شود که یک رابط اترنت نمایش داده شود.\&
.PP
\fBtooltip\-format\-wifi\fR:
.br
typeof: string
.br
این قالب زمانی استفاده می‌شود که یک رابط بی‌سیم نمایش داده شود.\&
.PP
\fBtooltip\-format\-disconnected\fR:
.br
typeof: string
.br
این قالب زمانی استفاده می‌شود که رابط نمایش‌داده‌شده قطع باشد.\&
.PP
\fBtooltip\-format\-disabled\fR:
.br
typeof: string
.br
این قالب زمانی استفاده می‌شود که rfkill رابط‌های wlan را مسدود کرده باشد.\&
.PP
\fBmenu\fR:
.br
typeof: string
.br
کنشی که منو را باز می‌کند.\&
.PP
\fBmenu\-file\fR:
.br
typeof: string
.br
محل پرونده توصیف‌گر منو.\& باید عنصری از نوع GtkMenu با شناسه \fBmenu\fR وجود داشته باشد.\&
.PP
\fBmenu\-actions\fR:
.br
typeof: array
.br
کنش‌های متناظر با دکمه‌های منو.\&
.PP
\fBexpand\fR:
.br
typeof: bool
.br
default: false
.br
به این ماژول امکان می‌دهد تا تمام فضای باقی‌مانده را به‌طور پویا مصرف کند.\&
.PP
.SH "جایگزین‌های قالب (FORMAT REPLACEMENTS)"
.PP
\fB{ifname}\fR: نام رابط شبکه.\&
.PP
\fB{ipaddr}\fR: نخستین IP رابط.\&
.PP
\fB{gwaddr}\fR: درگاه پیش‌فرض برای رابط
.PP
\fB{netmask}\fR: ماسک زیرشبکه متناظر با IP(V4).\&
.PP
\fB{netmask6}\fR: ماسک زیرشبکه متناظر با IP(V6).\&
.PP
\fB{cidr}\fR: ماسک زیرشبکه متناظر با IP(V4) در نماد CIDR.\&
.PP
\fB{cidr6}\fR: ماسک زیرشبکه متناظر با IP(V6) در نماد CIDR.\&
.PP
\fB{essid}\fR: نام (SSID) شبکه بی‌سیم.\&
.PP
\fB{bssid}\fR: آدرس MAC (یا BSSID) نقطه دسترسی بی‌سیم.\&
.PP
\fB{signalStrength}\fR: قدرت سیگنال شبکه بی‌سیم.\&
.PP
\fB{signaldBm}\fR: قدرت سیگنال شبکه بی‌سیم برحسب dBm.\&
.PP
\fB{frequency}\fR: فرکانس شبکه بی‌سیم برحسب گیگاهرتز (GHz).\&
.PP
\fB{bandwidthUpBits}\fR: سرعت لحظه‌ای بارگذاری برحسب بیت/ثانیه.\&
.PP
\fB{bandwidthDownBits}\fR: سرعت لحظه‌ای بارگیری برحسب بیت/ثانیه.\&
.PP
\fB{bandwidthTotalBits}\fR: مجموع سرعت لحظه‌ای برحسب بیت/ثانیه.\&
.PP
\fB{bandwidthUpOctets}\fR: سرعت لحظه‌ای بارگذاری برحسب هشت‌بایت/ثانیه.\&
.PP
\fB{bandwidthDownOctets}\fR: سرعت لحظه‌ای بارگیری برحسب هشت‌بایت/ثانیه.\&
.PP
\fB{bandwidthTotalOctets}\fR: مجموع سرعت لحظه‌ای برحسب هشت‌بایت/ثانیه.\&
.PP
\fB{bandwidthUpBytes}\fR: سرعت لحظه‌ای بارگذاری برحسب بایت/ثانیه.\&
.PP
\fB{bandwidthDownBytes}\fR: سرعت لحظه‌ای بارگیری برحسب بایت/ثانیه.\&
.PP
\fB{bandwidthTotalBytes}\fR: مجموع سرعت لحظه‌ای برحسب بایت/ثانیه.\&
.PP
\fB{icon}\fR: نماد، مطابق با تعریف در \fBformat\-icons\fR.\&
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
"network": {
	"interface": "wlp2s0",
	"format": "{ifname}",
	"format\-wifi": "{essid} ({signalStrength}%) ",
	"format\-ethernet": "{ifname} ",
	"format\-disconnected": "", //یک قالب خالی ماژول را پنهان می‌کند.
	"format\-disconnected": "",
	"tooltip\-format": "{ifname}",
	"tooltip\-format\-wifi": "{essid} ({signalStrength}%) ",
	"tooltip\-format\-ethernet": "{ifname} ",
	"tooltip\-format\-disconnected": "Disconnected",
	"max\-length": 50
}
.fi
.RE
.PP
.SH "استایل (STYLE)"
.PP
.PD 0
.IP \(bu 4
\fB#network\fR
.IP \(bu 4
\fB#network.\&disconnected\fR
.IP \(bu 4
\fB#network.\&disabled\fR
.IP \(bu 4
\fB#network.\&linked\fR
.IP \(bu 4
\fB#network.\&ethernet\fR
.IP \(bu 4
\fB#network.\&wifi\fR