.\" 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\-temperature" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar \- ماژول دما (temperature)
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول \fBtemperature\fR دمای فعلی را از یک ناحیه حرارتی (thermal zone) نمایش می‌دهد.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
قابل ارجاع با \fBtemperature\fR
.PP
\fBthermal\-zone\fR:
.br
نوع: عدد صحیح (integer)
.br
ناحیه حرارتی، همانند موجود در \fB/sys/class/thermal/\fR.\&
.PP
\fBhwmon\-path\fR:
.br
نوع: رشته (string)
.br
مسیر دمایی جهت استفاده، به عنوان مثال \fB/sys/class/hwmon/hwmon2/temp1_input\fR به جای مسیری در \fB/sys/class/thermal/\fR.\&
.RS 4
این گزینه همچنین می‌تواند آرایه‌ای از رشته‌ها باشد.\& در این حالت، waybar هر مورد در آرایه را بررسی کرده و از اولین مورد معتبر استفاده می‌کند.\&
این روش برای زمانی مناسب است که بخواهید فایل پیکربندی یکسانی را میان دستگاه‌های مختلف با پیکربندی‌های سخت‌افزاری متفاوت به اشتراک بگذارید.\&
.PP
.RE
\fBhwmon\-path\-abs\fR:
.br
نوع: رشته (string)
.br
مسیر دایرکتوری hwmon دستگاه، به عنوان مثال \fB/sys/devices/pci0000:00/0000:00:18.\&3/hwmon\fR.\& (توجه داشته باشید که زیردایرکتوری \fBhwmon/hwmon#\fR که در آن \fB#\fR یک عدد است، بخشی از مسیر نیست!\&) باید همراه با \fBinput\-filename\fR استفاده شود.\&
.RS 4
این گزینه همچنین می‌تواند آرایه‌ای از رشته‌ها باشد، که در این صورت درست مانند \fBhwmon\-path\fR عمل می‌کند.\&
.PP
.RE
\fBinput\-filename\fR:
.br
نوع: رشته (string)
.br
نام فایل دماییِ مربوط به \fBhwmon\-path\-abs\fR شما، به عنوان مثال \fBtemp1_input\fR
.PP
\fBwarning\-threshold\fR:
.br
نوع: عدد صحیح (integer)
.br
آستانه دمایی پیش از در نظر گرفته شدن به عنوان هشدار (به سلسیوس).\&
.PP
\fBcritical\-threshold\fR:
.br
نوع: عدد صحیح (integer)
.br
آستانه دمایی پیش از در نظر گرفته شدن به عنوان بحرانی (به سلسیوس).\&
.PP
\fBinterval\fR:
.br
نوع: عدد صحیح یا ممیز شناور (integer or float)
.br
پیش‌فرض: 10
.br
فاصله زمانی که اطلاعات در آن بازخوانی (poll) می‌شود.\&
.PP
\fBformat\-warning\fR:
.br
نوع: رشته (string)
.br
قالب مورد استفاده زمانی که دما در وضعیت هشدار قرار دارد.
.PP
\fBformat\-critical\fR:
.br
نوع: رشته (string)
.br
قالب مورد استفاده زمانی که دما در وضعیت بحرانی قرار دارد.
.PP
\fBformat\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: {temperatureC}°C
.br
قالب نمایش دما (سلسیوس/فارنهایت/کلوین).\&
.PP
\fBformat\-icons\fR:
.br
نوع: آرایه (array)
.br
بر اساس دمای فعلی (سلسیوس) و در صورت وجود \fBcritical\-threshold\fR، آیکون مربوطه انتخاب می‌شود.\& ترتیب از \fBlow\fR (پایین) به \fBhigh\fR (بالا) است.\&
.PP
\fBtooltip\-format\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: {temperatureC}°C
.br
قالب نمایش راهنمای ابزار (tooltip)
.PP
\fBrotate\fR:
.br
نوع: عدد صحیح (integer)
.br
مقدار مثبت برای چرخش برچسب متنی (در گام‌های ۹۰ درجه).\&
.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
گزینه‌ای برای غیرفعال‌سازی راهنمای ابزار هنگام رفتن ماوس روی آن.\&
.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{temperatureC}\fR: دما به سلسیوس.\&
.PP
\fB{temperatureF}\fR: دما به فارنهایت.\&
.PP
\fB{temperatureK}\fR: دما به کلوین.\&
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
 "temperature": {
	// "thermal\-zone": 2,
	// "hwmon\-path": ["/sys/class/hwmon/hwmon2/temp1_input", "/sys/class/thermal/thermal_zone0/temp"],
	// "critical\-threshold": 80,
	// "format\-critical": "{temperatureC}°C ",
	"format": "{temperatureC}°C "
}
.fi
.RE
.PP
.SH "سبک (STYLE)"
.PP
.PD 0
.IP \(bu 4
\fB#temperature\fR
.IP \(bu 4
\fB#temperature.\&warning\fR
.IP \(bu 4
\fB#temperature.\&critical\fR