'\" t
.\" Title: upsstats.html
.\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot
.\" Date: 06/21/2026
.\" Manual: NUT Manual
.\" Source: Network UPS Tools 2.8.5
.\" Language: Persian
.\"
.TH "UPSSTATS\&.HTML" "5" "06/21/2026" "Network UPS Tools 2\&.8\&.5" "NUT Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
upsstats.html \- قالب HTML برای ابزار تحت وب upsstats در Network UPS Tools
.SH "توضیحات (DESCRIPTION)"
.sp
این فایل، و فایل هم‌ساختار
.B upsstats\-single\&.html
برای برخی موارد کاربرد خاص، توسط
\fBupsstats.cgi\fR(8)
جهت تولید صفحات وضعیت CGI در NUT استفاده می‌شوند\&. دستورات مشخصی شناسایی شده و به صورت بلادرنگ با عناصر گوناگون وضعیت جایگزین خواهند شد\&.
.sp
به عنوان یک بررسی امنیتی، فایل باید حتماً با دستور @NUT_UPSSTATS_TEMPLATE@ شروع شود\&.
.sp
برای جزئیات بیشتر در خصوص پیکربندی برخی وب‌سرورهای پرکاربرد جهت اجرای برنامه‌های CGI در NUT، لطفاً به صفحه راهنمای
\fBupsset.conf\fR(5)
مراجعه کنید\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
.sp
این فایل قالب باید در مسیر پیکربندی NUT قرار گیرد\&. اگر از یک رونوشت اختصاصی از آن دایرکتوری استفاده می‌کنید یا نسخه‌ای که توسط باینری‌های منتقل‌شده به مکان‌های cgi\-bin وب‌سرور شما شناسایی نمی‌شود (مانند ساخت‌های NUT برای ویندوز که به طور پیش‌فرض مسیرها را نسبت به هر باینری جستجو می‌کنند)، صادر کردن متغیر محیطی NUT_CONFPATH را از وب‌سرور مد نظر قرار دهید\&.
.sp .5v
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
.sp
در پلتفرم‌هایی با پسوندهای الزامی برای نام فایل‌های برنامه، مانند ویندوز، ممکن است مجبور شوید به عنوان مثال از پسوند *\&.cgi\&.exe برای برنامه‌ها در فایل‌های قالب HTML استفاده کنید (مانند UPSSTATSPATH و UPSIMAGEPATH)\&.
.sp .5v
.RE
.SH "قالب‌بندی (FORMATTING)"
.sp
دستورات می‌توانند در هر کجای یک خط قرار گیرند، اما باید با @ آغاز شده و با @ پایان یابند\&.
.sp
هرگونه نویسه اضافی قبل یا بعد از دستورات بدون تغییر عبور داده خواهد شد\&.
.sp
استفاده از بیش از یک دستور در یک خط مجاز است، مادامی که هر دستور دارای نویسه شروع و پایان مختص به خود باشد\&.
.sp
اگر نیاز به استفاده از نویسه @ دارید، از موجودیت HTML به صورت @ استفاده کنید تا به عنوان نویسه شروع تلقی نشود\&.
.SH "کنترل بلوک (BLOCK CONTROL)"
.sp
برخی دستورات بلوک‌ها را آغاز می‌کنند \(em بخش‌هایی از قالب که بسته به پارامترهای معین، گنجانده، حذف یا تکرار می‌شوند\&.
.SS "کنترل بلوک \- تکرار (BLOCK CONTROL \- ITERATION)"
.PP
\fB@FOREACHUPS@\fR
.RS 4
بلوکی را آغاز می‌کند که برای هر دستورالعمل MONITOR در
\fBhosts.conf\fR(5)
تکرار خواهد شد\&. به این ترتیب می‌توانید صفحاتی تولید کنید که تمامی سیستم‌های شما را به صورت همزمان نظارت می‌کنند\&.
.RE
.PP
\fB@ENDFOR@\fR
.RS 4
به یک بلوک FOREACHUPS پایان می‌دهد\&.
.RE
.SS "کنترل بلوک \- تطبیق موارد خاص (BLOCK CONTROL \- MATCHING SPECIFIC CASES)"
.PP
\fB@IFSUPP \fR\fB\fIvar\fR\fR@*
.RS 4
بلوکی را آغاز می‌کند که فقط در صورت پشتیبانی متغیر var توسط یوپی‌اس جاری چاپ خواهد شد\&. این دستور عموماً برای جلوگیری از نمایش پیام‌های "not supported" با اجتناب کامل از فراخوانی برچسب و متغیر به کار می‌رود\&.
.RE
.PP
\fB@IFEQ\fR \fIvar\fR \fIvalue\fR\fB@\fR
.RS 4
بلوکی را آغاز می‌کند اگر مقدار بازگردانده‌شده از متغیر
\fIvar\fR
با
\fIvalue\fR
مطابقت داشته باشد\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
می‌توانید از
@IFEQ upsstats\&.use_celsius (0|1)@
برای بررسی تنظیم فعلی کلید تغییر وضعیت
\fB@TEMPC@\fR
یا
\fB@TEMPF@\fR
استفاده کنید\&.
.sp .5v
.RE
.RE
.PP
\fB@IFBETWEEN\fR \fIvarlow\fR \fIvarhigh\fR \fIvarvalue\fR\fB@\fR
.RS 4
بلوکی را آغاز می‌کند اگر مقدار بازگردانده‌شده توسط متغیر
\fIvarvalue\fR
بین مقادیر بازگردانده‌شده توسط متغیرهای
\fIvarlow\fR
و
\fIvarhigh\fR
باشد\&.
.RE
.PP
\fB@ELSE@\fR
.RS 4
اگر دستور IF قبلی مطابقت نداشت، به جای آن این بخش را اجرا می‌کند\&.
.RE
.PP
\fB@ENDIF@\fR
.RS 4
به یک بلوک IF/ELSE پایان می‌دهد\&.
.RE
.SS "کنترل بلوک \- عبارات پیشرفته (BLOCK CONTROL \- ADVANCED EXPRESSIONS)"
.sp
اگرچه تجزیه‌کننده تا حدودی محدود است، اما همچنان امکان ساخت عبارات نسبتاً پیشرفته وجود دارد\&. کلید دستیابی به این هدف، این واقعیت است که چند دستور کنترل بلوک با یکدیگر AND می‌شوند\&. این ساختار با یک مثال شرح داده شده است (مثال‌های بیشتر در upsstats\&.html موجود است)\&.
.sp
.if n \{\
.RS 4
.\}
.nf
@IFSUPP ambient\&.humidity@
@IFSUPP ambient\&.temperature@
این یوپی‌اس هم دمای محیط و هم رطوبت محیط را می‌شناسد\&.
@ELSE@
@IFSUPP ambient\&.humidity@
این یوپی‌اس فقط رطوبت محیط را می‌شناسد\&.
@ELSE@
@IFSUPP ambient\&.temperature@
این یوپی‌اس فقط دمای محیط را می‌شناسد\&.
@ELSE@
این یوپی‌اس چیزی نمی‌داند، چه آزاردهنده\&.
@ENDIF@
.fi
.if n \{\
.RE
.\}
.SH "سایر دستورات (OTHER COMMANDS)"
.PP
\fB@NUT_UPSSTATS_TEMPLATE [args]@\fR
.RS 4
فایل قالب الزاماً باید دقیقاً با
@NUT_UPSSTATS_TEMPLATE@
یا
@NUT_UPSSTATS_TEMPLATE Some text@
آغاز شود تا
\fBupsstats.cgi\fR(8)
وادار به نمایش فایل‌های دلخواه نشود\&.
.sp
در حال حاضر این دستور و آرگومان‌های آن نادیده گرفته می‌شوند؛ قالب‌های ارائه‌شده همراه با NUT از مقادیر آرگومان "default" و "single" عملاً به عنوان توضیحاتی برای اشکال‌زدایی و عیب‌یابی استفاده می‌کنند\&.
.RE
.PP
\fB@UPSSTATSPATH filename@\fR
.RS 4
شناسه URI برای برنامه
\fBupsstats.cgi\fR(8)
که در ارجاعات HTML قرار می‌گیرد\&. حالت پیش‌فرض نام برنامه است که آن را به پیوندی نسبی با صفحه در حال نمایش در مرورگر تبدیل می‌کند\&.
.sp
ممکن است لازم باشد پسوند نام فایل برنامه مختص به پلتفرم را نیز شامل شود، مانند
@UPSSTATSPATH upsstats\&.cgi\&.exe@
.RE
.PP
\fB@UPSIMAGEPATH filename@\fR
.RS 4
شناسه URI برای برنامه
\fBupsimage.cgi\fR(8)
که در ارجاعات HTML قرار می‌گیرد\&. حالت پیش‌فرض نام برنامه است که آن را به پیوندی نسبی با صفحه در حال نمایش در مرورگر تبدیل می‌کند\&.
.sp
ممکن است لازم باشد پسوند نام فایل برنامه مختص به پلتفرم را نیز شامل شود، مانند
@UPSIMAGEPATH upsimage\&.cgi\&.exe@
.RE
.PP
\fB@AMBTEMP@\fR
.RS 4
درج دمای محیط در مقیاس دمایی فعلی\&.
.RE
.PP
\fB@DATE\fR \fIformat\fR\fB@\fR
.RS 4
درج تاریخ و زمان فعلی\&. رشته قالب‌بندی به
strftime
ارسال می‌شود، بنابراین تقریباً هر قالبی امکان‌پذیر است\&. برای مقادیر مجاز به
\fBstrftime\fR(3)
مراجعه کنید\&.
.RE
.PP
\fB@DEGREES@\fR
.RS 4
درج نویسه موجودیت برای درجه (\(de) و سپس C یا F بسته به مقیاس دمای فعلی\&.
.RE
.PP
\fB@HOST@\fR
.RS 4
درج شناسه میزبانی که نظارت می‌شود، مانند
myups@localhost\&.
.RE
.PP
\fB@HOSTDESC@\fR
.RS 4
درج شرح میزبان از
\fBhosts.conf\fR(5)\&.
.RE
.PP
\fB@HOSTLINK@\fR
.RS 4
درج یک پیوند HTML به
\fBupsstats.cgi\fR(8)
در حالی که متغیر "host" روی یوپی‌اس جاری تنظیم شده است\&. این دستور تنها درون یک بلوک FOREACHUPS کاربرد دارد\&.
.RE
.PP
\fB@TREELINK [Link text]@\fR
.RS 4
درج یک پیوند HTML به
\fBupsstats.cgi\fR(8)
در حالی که متغیر "host" روی یوپی‌اس جاری تنظیم شده و "treemode" برای نمایش تمام نقاط داده به صورت یک صفحه HTML فعال است\&. این دستور در وهله اول درون یک بلوک FOREACHUPS مفید است، اما به عنوان پاورقی در
upsstats\-single\&.html
نیز کاربرد دارد\&. در صورتی که "Link text" ارائه نشود، مقدار پیش‌فرض آن "All data" خواهد بود\&.
.RE
.PP
\fB@TREELINK_JSON [Link text]@\fR
.RS 4
درج یک پیوند HTML به
\fBupsstats.cgi\fR(8)
در حالی که متغیر "host" روی یوپی‌اس جاری تنظیم شده و "treemode" برای نمایش تمام نقاط داده به صورت یک سند JSON فعال است\&. این دستور در وهله اول درون یک بلوک FOREACHUPS مفید است، اما به عنوان پاورقی در
upsstats\-single\&.html
نیز کاربرد دارد\&. در صورتی که "Link text" ارائه نشود، مقدار پیش‌فرض آن "JSON" خواهد بود\&.
.RE
.PP
\fB@IMG\fR \fIvarname\fR \fB@\fR
.RS 4
درج یک تگ IMG SRC به
\fBupsimage.cgi\fR(8)
برای یکی از این متغیرهای وضعیت:
.PP
battery\&.charge
.RS 4
شارژ باتری \(em بر حسب درصد
.RE
.PP
battery\&.voltage
.RS 4
میزان شارژ باتری بر حسب ولت
.RE
.PP
input\&.frequency
.RS 4
فرکانس برق ورودی (هرتز)
.RE
.PP
input\&.voltage
.RS 4
ولتاژ برق ورودی
.RE
.PP
input\&.L1\-L2\&.voltage
.RS 4
ولتاژ ورودی، L1\-L2 (سه فاز)
.RE
.PP
input\&.L2\-L3\&.voltage
.RS 4
ولتاژ ورودی، L2\-L3 (سه فاز)
.RE
.PP
input\&.L3\-L1\&.voltage
.RS 4
ولتاژ ورودی، L3\-L1 (سه فاز)
.RE
.PP
output\&.frequency
.RS 4
فرکانس برق خروجی (هرتز)
.RE
.PP
output\&.voltage
.RS 4
ولتاژ خروجی (از یوپی‌اس)
.RE
.PP
output\&.L1\-L2\&.voltage
.RS 4
ولتاژ خروجی، L1\-L2 (سه فاز)
.RE
.PP
output\&.L2\-L3\&.voltage
.RS 4
ولتاژ خروجی، L2\-L3 (سه فاز)
.RE
.PP
output\&.L3\-L1\&.voltage
.RS 4
ولتاژ خروجی، L3\-L1 (سه فاز)
.RE
.PP
output\&.L1\&.power\&.percent
.RS 4
بار یوپی‌اس، L1 (سه فاز)
.RE
.PP
output\&.L2\&.power\&.percent
.RS 4
بار یوپی‌اس، L2 (سه فاز)
.RE
.PP
output\&.L3\&.power\&.percent
.RS 4
بار یوپی‌اس، L3 (سه فاز)
.RE
.PP
ups\&.load
.RS 4
بار یوپی‌اس \(em بر حسب درصد
.RE
.PP
ups\&.temperature
.RS 4
دمای یوپی‌اس
.RE
.RE
.sp
بخش \fIextra\fR جایی است که می‌توانید تعاریف اضافی را در آن قرار دهید\&. در حال حاضر تعاریف معتبر، رنگ‌ها برای بخش‌های مختلف نوارهای رسم‌شده توسط \fBupsimage.cgi\fR(8) هستند\&. نام‌های مجاز رنگ عبارتند از:
.PP
back_col
.RS 4
رنگ پس‌زمینه
.RE
.PP
scale_num_col
.RS 4
رنگ شماره‌های مقیاس
.RE
.PP
summary_col
.RS 4
رنگ خلاصه (عدد در پایین)
.RE
.PP
ok_zone_maj_col
.RS 4
رنگ مقیاس اصلی برای ناحیه عادی ("ok")
.RE
.PP
ok_zone_min_col
.RS 4
رنگ مقیاس فرعی برای ناحیه عادی ("ok")
.RE
.PP
neutral_zone_maj_col
.RS 4
رنگ مقیاس اصلی برای ناحیه خنثی
.RE
.PP
neutral_zone_min_col
.RS 4
رنگ مقیاس فرعی برای ناحیه خنثی
.RE
.PP
warn_zone_maj_col
.RS 4
رنگ مقیاس اصلی برای ناحیه هشدار
.RE
.PP
warn_zone_min_col
.RS 4
رنگ مقیاس فرعی برای ناحیه هشدار
.RE
.PP
bar_col
.RS 4
رنگ نوار در وسط
.RE
.sp
تمام رنگ‌ها سه‌تایی‌های هگزادسیمال هستند \(em مانند 0xff0000 برای قرمز، 0x00ff00 برای سبز و 0x0000ff برای آبی\&.
.sp
مثال‌ها:
.sp
.if n \{\
.RS 4
.\}
.nf
@IMG battery\&.charge@
@IMG battery\&.charge back_col=0xff00ff bar_col=0xaabbcc@
@IMG input\&.voltage ok_zone_maj_col=0x123456@
.fi
.if n \{\
.RE
.\}
.PP
\fB@REFRESH@\fR
.RS 4
درج جادوی هدر META برای تازه‌سازی صفحه در صورتی که این متغیر توسط مرورگر تنظیم شده باشد\&. این دستور باید در بخش HEAD صفحه قرار گیرد\&.
.RE
.PP
\fB@STATUS separator@\fR, \fB@STATUS@\fR
.RS 4
گسترش اختصارات در متغیر ups\&.status \(em عبارت OL به "On line"، عبارت OB به "On battery" و موارد دیگر تبدیل می‌شود\&. مقادیر گزارش‌شده توسط جداکننده اختیاری مشخص‌شده جدا می‌شوند (
اگر مشخص نشده باشد)، که از نویسه بعدی پس از "STATUS" آغاز می‌شود (به عنوان مثال، یک دستورالعمل
@STATUS @
ممکن است برای اجتناب از هرگونه جداسازی استفاده شود، یا
@STATUS @
برای جداسازی با فاصله)\&.
.RE
.PP
\fB@STATUSCOLOR@\fR
.RS 4
درج سه‌تایی‌های رنگ قرمز، سبز یا زرد بسته به شدت وضعیت فعلی یوپی‌اس\&. عملیات عادی سبز است، هشدارهایی مانند تقویت یا کاهش ولتاژ (trim/boost) یا "off" زرد هستند، و رویدادهای دیگر مانند کار روی باتری یا باتری ضعیف قرمز هستند\&.
.RE
.PP
\fB@VAR\fR \fIvarname\fR\fB@\fR
.RS 4
درج مقدار فعلی متغیر وضعیت varname در میزبان تحت نظارت، یا عبارت "Not supported"\&.
.RE
.PP
\fB@RUNTIME@\fR
.RS 4
درج زمان کارکرد فعلی، در قالب
hh:mm:ss\&.
.RE
.PP
\fB@TEMPC@\fR
.RS 4
استفاده از مقیاس سلسیوس برای داده‌های دما (پیش‌فرض)\&.
.RE
.PP
\fB@TEMPF@\fR
.RS 4
استفاده از مقیاس فارنهایت برای داده‌های دما\&.
.RE
.PP
\fB@UPSTEMP@\fR
.RS 4
درج دمای یوپی‌اس در مقیاس فعلی\&.
.RE
.PP
\fB@BATTTEMP@\fR
.RS 4
درج دمای باتری در مقیاس فعلی\&.
.RE
.PP
\fB@UTILITYCOLOR@\fR
.RS 4
منسوخ شده است\&. به جای آن از IFBETWEEN استفاده کنید (مثال موجود در upsstats\&.html را ببینید)\&.
.RE
.PP
\fB@VERSION@\fR
.RS 4
درج شماره نسخه نرم‌افزار\&.
.RE
.SH "سایر قالب‌ها (OTHER TEMPLATES)"
.sp
\fBupsstats.cgi\fR(8) همچنین فایلی به نام upsstats\-single\&.html را در صورت فراخوانی با مقدار host= تنظیم‌شده در URL باز خواهد کرد\&. آن فایل از همان قوانین و تکنیک‌های مستندشده در اینجا استفاده می‌کند\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBupsstats.cgi\fR(8), \fBupsimage.cgi\fR(8)
.SS "منابع اینترنتی: (Internet resources:)"
.sp
صفحه اصلی NUT (Network UPS Tools): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5