.\" 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\-disk" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar\-disk \- ماژول فضای دیسک در waybar
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول \fBdisk\fR میزان فضای مصرف‌شده دیسک را در حال حاضر نمایش می‌دهد.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
با نام \fBdisk\fR آدرس‌دهی می‌شود.
.PP
\fBpath\fR: 
.br
نوع: رشته (string)
.br
پیش‌فرض: "/" 
.br
هر مسیری درون فایل‌سیستم یا نقطه اتصالی (mountpoint) که اطلاعات آن باید نمایش داده شود.\&
.PP
\fBinterval\fR: 
.br
نوع: عدد صحیح (integer)
.br
پیش‌فرض: 30 
.br
بازه زمانی دریافت دوره‌ای اطلاعات (بر حسب ثانیه).\&
.PP
\fBformat\fR: 
.br
نوع: رشته (string)
.br
پیش‌فرض: "{percentage_used}%" 
.br
قالب نحوه نمایش اطلاعات.\&
.PP
\fBrotate\fR: 
.br
نوع: عدد صحیح (integer)
.br
مقدار مثبت جهت چرخاندن برچسب متنی (با گام‌های ۹۰ درجه).\&
.PP
\fBstates\fR: 
.br
نوع: شیء (object)
.br
تعدادی از وضعیت‌های مصرف دیسک که بر اساس آستانه‌های درصدی مشخص (percentage_used) فعال می‌شوند.\& ببینید \fBwaybar\-states(5)\fR.\&
.PP
\fBmax\-length\fR: 
.br
نوع: عدد صحیح (integer)
.br
حداکثر طول برچسب بر حسب کاراکتر که ماژول باید نمایش دهد.\&
.PP
\fBmin\-length\fR: 
.br
نوع: عدد صحیح (integer)
.br
حداقل طول برچسب بر حسب کاراکتر که ماژول باید بپذیرد.\&
.PP
\fBalign\fR: 
.br
نوع: ممیز شناور (float)
.br
تراز برچسب در داخل ماژول، که در آن 0 چپ‌چین و 1 راست‌چین است.\& اگر ماژول چرخانده شود، از جریان متن پیروی می‌کند.\&
.PP
\fBjustify\fR: 
.br
نوع: رشته (string)
.br
تراز متن درون برچسب ماژول، که گزینه‌های '\&left' (چپ)، '\&right' (راست) یا '\&center' (وسط) را جهت تعیین موقعیت می‌پذیرد.\&
.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
\fBon\-scroll\-up\fR: 
.br
نوع: رشته (string)
.br
دستوری که هنگام پیمایش به بالا (اسکرول) روی ماژول اجرا می‌شود.\&
.PP
\fBon\-scroll\-down\fR: 
.br
نوع: رشته (string)
.br
دستوری که هنگام پیمایش به پایین روی ماژول اجرا می‌شود.\&
.PP
\fBsmooth\-scrolling\-threshold\fR: 
.br
نوع: اعشاری (double)
.br
آستانه مورد استفاده هنگام پیمایش روان.\&
.PP
\fBtooltip\fR: 
.br
نوع: بولی (bool)
.br
پیش‌فرض: true 
.br
گزینه‌ای برای غیرفعال کردن راهنمای شناور (tooltip) هنگام قرار گرفتن نشانگر ماوس روی ماژول.\&
.PP
\fBtooltip\-format\fR: 
.br
نوع: رشته (string)
.br
پیش‌فرض: "{used} out of {total} used ({percentage_used}%)" 
.br
قالب اطلاعات نمایش‌داده‌شده در راهنمای شناور.\&
.PP
\fBunit\fR: 
.br
نوع: رشته (string)
.br
همراه با specific_free ،specific_used و specific_total استفاده می‌شود تا محاسبات را همواره در یک واحد مشخص مقید کند.\& واحدهای kB ،kiB ،MB ،Mib ،GB ،GiB ،TB و TiB را می‌پذیرد.\&
.PP
\fBmenu\fR: 
.br
نوع: رشته (string)
.br
عملیاتی که منو را باز می‌کند.\&
.PP
\fBmenu\-file\fR: 
.br
نوع: رشته (string)
.br
محل فایل توصیف‌کننده منو.\& باید عنصری از نوع
.RS 4
GtkMenu با شناسه \fBmenu\fR وجود داشته باشد.
.PP
.RE
\fBmenu\-actions\fR: 
.br
نوع: آرایه (array)
.br
عملیات متناظر با دکمه‌های منو.\&
.PP
\fBexpand\fR: 
.br
نوع: بولی (bool)
.br
پیش‌فرض: false 
.br
به این ماژول اجازه می‌دهد تمام فضای باقی‌مانده را به صورت پویا اشغال کند.\&
.PP
.SH "جایگزین‌های قالب‌بندی (FORMAT REPLACEMENTS)"
.PP
\fB{percentage_used}\fR: درصد فضای دیسک در حال استفاده.\&
.PP
\fB{percentage_free}\fR: درصد فضای آزاد دیسک.\&
.PP
\fB{total}\fR: مقدار کل فضای دیسک، پارتیشن یا نقطه اتصال.\& واحد را به‌طور خودکار بر اساس اندازه باقی‌مانده انتخاب می‌کند.\&
.PP
\fB{used}\fR: مقدار فضای استفاده‌شده دیسک.\& واحد را به‌طور خودکار بر اساس اندازه باقی‌مانده انتخاب می‌کند.\&
.PP
\fB{free}\fR: مقدار فضای آزاد دیسک برای کاربران عادی.\& واحد را به‌طور خودکار بر اساس اندازه باقی‌مانده انتخاب می‌کند.\&
.PP
\fB{path}\fR: مسیر مشخص‌شده در پیکربندی.\&
.PP
\fB{specific_total}\fR: مقدار کل فضای دیسک، پارتیشن یا نقطه اتصال در یک واحد مشخص.\& پیش‌فرض بر حسب بایت است.\&
.PP
\fB{specific_used}\fR: مقدار فضای استفاده‌شده دیسک در یک واحد مشخص.\& پیش‌فرض بر حسب بایت است.\&
.PP
\fB{specific_free}\fR: مقدار فضای آزاد دیسک برای کاربران عادی در یک واحد مشخص.\& پیش‌فرض بر حسب بایت است.\&
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
"disk": {
	"interval": 30,
	"format": "{percentage_free}% free on {path}",
}
.fi
.RE
.PP
.nf
.RS 4
"disk": {
	"interval": 30,
	"format": "{specific_free:0\&.2f} GB out of {specific_total:0\&.2f} GB available\&. Alternatively {free} out of {total} available",
	"unit": "GB"
	// 1434\&.25 GB out of 2000\&.00 GB available\&. Alternatively 1\&.4TiB out of 1\&.9TiB available\&.
}
.fi
.RE
.PP
.SH "استایل (STYLE)"
.PP
.PD 0
.IP \(bu 4
\fB#disk\fR