.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "INNREPORT 8"
.TH INNREPORT 8 2022-07-10 "INN 2.7.4" "InterNetNews Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
innreport \- خلاصه‌سازی پرونده‌های گزارش INN
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBinnreport\fR \fB\-f\fR \fIconfig-file\fR [\fB\-config\fR] [\fB\-help\fR] [\fB\-v\fR]
[\fB\-\fR[\fBno\fR]\fBarchive\fR] [\fB\-\fR[\fBno\fR]\fBcasesensitive\fR] [\fB\-\fR[\fBno\fR]\fBgraph\fR]
[\fB\-\fR[\fBno\fR]\fBhtml\fR] [\fB\-\fR[\fBno\fR]\fBhtml-unknown\fR] [\fB\-\fR[\fBno\fR]\fBnotdaily\fR]
[\fB\-\fR[\fBno\fR]\fBunknown\fR] [\fB\-cycle\fR \fInum-cycle\fR] [\fB\-dir\fR \fIhttp-dir\fR]
[\fB\-index\fR \fIindex-file\fR] [\fB\-maxunrec\fR \fInum-lines\fR]
[\fB\-path\fR \fIpictures-dir\fR] [\fB\-separator\fR \fIchar\fR]
[\fB\-webpath\fR \fIpictures-path\fR] \fIlog-file\fR [\fIlog-file\fR ...]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور
\&\fBinnreport\fR
یک اسکریپت پرل (Perl) است که پرونده‌های گزارش INN را همراه با امکان اختیاری تولید خروجی HTML و نمودارها خلاصه‌سازی می‌کند. این دستور معمولاً توسط scanlogs(8) فراخوانی می‌شود که خروجی
\&\fBinnreport\fR
را در گزارش‌های روزانهٔ یوزنت (Usenet) می‌گنجاند.
.PP
برنامه‌های پشتیبانی‌شده عبارتند از
\&\fBbatcher\fR،
\&\fBcnfsstat\fR،
\&\fBcontrolchan\fR،
\&\fBinnd\fR،
\&\fBinnfeed\fR،
\&\fBinnxbatch\fR،
\&\fBinnxmit\fR،
\&\fBnnrpd\fR،
\&\fBnntplink\fR
(یک برنامهٔ خارجی)،
\&\fBoverchan\fR،
\&\fBperl-nocem\fR
و
\&\fBrnews\fR.
.PP
دستور
\&\fBinnreport\fR
همچنین شمار گروه‌های خبری را که به‌طور محلی توسط کارساز اخبار میزبانی نمی‌شوند اما مقالاتی برای آن‌ها دریافت شده است، در پروندهٔ گزارش
\&\fIunwanted.log\fR
به‌روزرسانی می‌کند. اگر این به‌روزرسانی نباید انجام شود (از آنجا که هنگام تجزیهٔ گزارش‌های روزانه فقط باید یک‌بار در روز رخ دهد)، پرچم
\&\fB\-notdaily\fR
باید به
\&\fBinnreport\fR
داده شود.
.PP
اگر می‌خواهید
\&\fBinnreport\fR
در گزارش‌های HTML خود نمودار تولید کند، به کتابخانهٔ گرافیکی پرل
\&\fIGD.pm\fR
نیاز دارید.
.PP
حداقل یک پروندهٔ گزارش غیرخالی برای تجزیه باید در انتهای خط فرمانِ فراخوانندهٔ
\&\fBinnreport\fR
ارائه شود.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
تنها یک گزینه اجباری است:
.IP "\fB\-f\fR \fIconfig-file\fR" 4
.IX Item "-f config-file"
مسیر کامل به پروندهٔ پیکربندی. این پرونده معمولاً
\&\fIinnreport.conf\fR
در
\&\fIpathetc\fR
است، اما مقدار پیش‌فرضی وجود ندارد. این پرونده گزینه‌های مورد استفاده برای گزارش را فهرست می‌کند. گزینه‌های داده‌شده در خط فرمان هنگام فراخوانی
\&\fBinnreport\fR
بر گزینه‌های موجود در پروندهٔ پیکربندی اولویت دارند.
.PP
سایر گزینه‌ها اختیاری هستند. افزودن پیشوند
\&\f(CW\*(C`no\*(C'\fR
به ابتدای گزینه‌های بولی، امکان غیرفعال کردن آن‌ها را فراهم می‌کند. برای نمونه، از
\&\fB\-nograph\fR
برای حذف قابلیتی که
\&\fB\-graph\fR
فعال می‌کند، استفاده کنید.
.IP "\fB\-archive\fR یا \fB\-a\fR" 4
.IX Item "-archive or -a"
مشخص می‌کند که آیا در صورت فعال بودن گزارش‌های HTML، صفحات HTML و نمودارها بایگانی شوند یا خیر. هنگامی که این گزینه تنظیم شود (که حالت پیش‌فرض است)، تاریخی به نام پروندهٔ هر گزارش و هر نمودار اضافه خواهد شد. در غیر این صورت، تنها آخرین گزارش HTML نگهداری می‌شود.
.IP \fB\-casesensitive\fR 4
.IX Item "-casesensitive"
مشخص می‌کند که آیا جستجو در پرونده‌های گزارش اخبار برای الگوهای از پیش تعیین‌شده به بزرگی و کوچکی حروف حساس باشد یا خیر. این گزینه به‌طور پیش‌فرض فعال است.
.IP \fB\-config\fR 4
.IX Item "-config"
اطلاعات پیکربندی
\&\fBinnreport\fR
را در خروجی استاندارد چاپ کرده و خارج می‌شود.
.IP "\fB\-cycle\fR یا \fB\-c\fR \fInum-cycle\fR" 4
.IX Item "-cycle or -c num-cycle"
تعداد پرونده‌های گزارشی را که در صورت فعال بودن و بایگانی شدن گزارش‌های HTML باید نگهداری شوند، تعیین می‌کند. مقدار پیش‌فرض
\&\f(CW\*(C`0\*(C'\fR
است، به این معنی که تمام بایگانی‌ها نگهداری می‌شوند.
.IP "\fB\-dir\fR یا \fB\-d\fR \fIhttp-dir\fR" 4
.IX Item "-dir or -d http-dir"
در صورت فعال بودن گزارش‌های HTML، دایرکتوری صفحات وب را تعیین می‌کند. مقدار پیش‌فرض، مقدار
\&\fIpathhttp\fR
تنظیم‌شده در
\&\fIinn.conf\fR
است.
.IP "\fB\-graph\fR یا \fB\-g\fR" 4
.IX Item "-graph or -g"
اگر کتابخانهٔ گرافیکی پرل
\&\fIGD.pm\fR
نصب شده باشد و گزارش‌های HTML فعال باشند، نمودارها در صورت پشتیبانی توسط
\&\f(CW\*(C`GD\*(C'\fR
به‌صورت PNG تولید می‌شوند که در نسخه‌های امروزی چنین است (در غیر این صورت به‌صورت GIF تولید خواهند شد). حالت پیش‌فرض، فعال بودن تولید نمودار است.
.IP "\fB\-help\fR یا \fB\-h\fR" 4
.IX Item "-help or -h"
یک پیام راهنما حاوی تمام گزینه‌های شناخته‌شده توسط
\&\fBinnreport\fR
را در خروجی استاندارد چاپ کرده و خارج می‌شود.
.IP \fB\-html\fR 4
.IX Item "-html"
علاوه بر گزارش متنی ساده که در خروجی استاندارد چاپ می‌شود، در صورت فعال بودن این گزینه،
\&\fBinnreport\fR
گزارش‌های HTML نیز تولید می‌کند. این گزینه به‌طور پیش‌فرض غیرفعال است (یعنی
\&\fB\-nohtml\fR
حالت پیش‌فرض است).
.IP \fB\-html\-unknown\fR 4
.IX Item "-html-unknown"
مشخص می‌کند که آیا ورودی‌های ناشناخته از پرونده‌های گزارش اخبار در صورت فعال بودن، در گزارش‌های HTML گزارش شوند یا خیر. این گزینه به‌طور پیش‌فرض همان مقداری را می‌گیرد که برای گزارش‌های متنی ساده تعیین شده است (همان‌طور که با گزینهٔ
\&\fIunknown\fR
تنظیم می‌شود).
.IP "\fB\-index\fR یا \fB\-i\fR" 4
.IX Item "-index or -i"
در صورت فعال بودن گزارش‌های HTML، نام صفحهٔ وب شاخص را تعیین می‌کند. مقدار پیش‌فرض
\&\f(CW\*(C`index.html\*(C'\fR
است.
.IP "\fB\-maxunrec\fR \fInum-lines\fR" 4
.IX Item "-maxunrec num-lines"
تعداد ورودی‌های ناشناخته از پرونده‌های گزارش اخبار را که هنگام تنظیم بودن گزینه‌های
\&\fB\-unknown\fR
یا
\&\fB\-html\-unknown\fR
باید گزارش شوند، مشخص می‌کند. مقدار پیش‌فرض
\&\f(CW\*(C`50\*(C'\fR
است. استفاده از
\&\f(CW\*(C`\-1\*(C'\fR
به این معنی است که هیچ محدودیتی وجود ندارد.
.IP \fB\-notdaily\fR 4
.IX Item "-notdaily"
مشخص می‌کند که آیا اقدامات روزانه برای این اجرای
\&\fBinnreport\fR
به تعویق بیفتد یا خیر. برخی اقدامات باید تنها یک‌بار در روز برای یک پروندهٔ گزارش انجام شوند (به‌ویژه
\&\fIunwanted.log\fR).
این گزینه به‌طور پیش‌فرض غیرفعال است، به این معنی که تمام اقدامات همیشه انجام می‌شوند، زیرا فرض بر این است که اجرای معمول
\&\fBscanlogs\fR
به‌صورت روزانه انجام می‌گیرد.
.IP "\fB\-path\fR یا \fB\-p\fR \fIpictures-dir\fR" 4
.IX Item "-path or -p pictures-dir"
در صورت فعال بودن گزارش‌های HTML و درخواست تولید نمودارها، دایرکتوری تصاویر را تعیین می‌کند. مقدار پیش‌فرض
\&\fIpathhttp\fR/\fIpics\fR
است.
.Sp
اگر هر دو گزینهٔ
\&\fB\-dir\fR
و
\&\fB\-webpath\fR
استفاده شوند اما
\&\fB\-path\fR
استفاده نشود، دایرکتوری مورد استفاده برای تصاویر به‌طور پیش‌فرض برابر با
\&\fIhttp-dir تنظیم‌شده با \fR\f(BI\-dir\fR/\fIpictures-path تنظیم‌شده با \fR\f(BI\-webpath\fR\fI\fR
خواهد بود.
.IP "\fB\-separator\fR یا \fB\-s\fR \fIchar\fR" 4
.IX Item "-separator or -s char"
در صورت فعال بودن و بایگانی شدن گزارش‌های HTML، جداکنندهٔ بین ساعت، دقیقه و ثانیه را در نام پرونده‌ها تعیین می‌کند. مقدار پیش‌فرض
\&\f(CW\*(C`.\*(C'\fR
است زیرا ممکن است
\&\f(CW\*(C`:\*(C'\fR
توسط تمام مرورگرهای وب به‌درستی خوانده نشود. دقت کنید که از
\&\f(CW\*(C`/\*(C'\fR
به‌عنوان جداکننده استفاده \fIنکنید\fR، و تنها از نویسه‌های معتبر برای نام پرونده استفاده نمایید.
.IP \fB\-unknown\fR 4
.IX Item "-unknown"
مشخص می‌کند که آیا ورودی‌های ناشناخته از پرونده‌های گزارش اخبار در گزارش‌های متنی ساده گزارش شوند یا خیر. این گزینه به‌طور پیش‌فرض فعال است.
.IP \fB\-v\fR 4
.IX Item "-v"
شماره نگارش
\&\fBinnreport\fR
را در خروجی استاندارد چاپ کرده و خارج می‌شود.
.IP "\fB\-webpath\fR یا \fB\-w\fR \fIpictures-path\fR" 4
.IX Item "-webpath or -w pictures-path"
در صورت فعال بودن گزارش‌های HTML و درخواست تولید نمودارها، مسیر وب تصاویر را در صفحات HTML تعیین می‌کند. مقدار پیش‌فرض
\&\f(CW\*(C`pics\*(C'\fR
است. این مسیر می‌تواند یک مسیر نسبی یا یک مسیر مطلق باشد. اگر از یک مسیر مطلق استفاده شود، باید
\&\fB\-path\fR
را نیز به‌درستی تنظیم کنید؛ در غیر این صورت به‌درستی محاسبه نخواهد شد.
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
نوشته‌شده توسط Fabien Tassin <fta@sofaraway.org> برای InterNetNews. بازنویسی‌شده در قالب POD توسط Julien Elie.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
innreport.conf(5), news.daily(8), newslog(5), scanlogs(8).