.\" -*- 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 "NEWS2MAIL 8"
.TH NEWS2MAIL 8 2026-06-12 "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)"
news2mail \- اسکریپت کانال برای ارسال مقالات خبری به ایمیل
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBnews2mail\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
اسکریپت
\&\fBnews2mail\fR
به عنوان یک فرآیند کانال (channel process) تحت نظارت
\fBinnd\fR
اجرا می‌شود. این ابزار به عنوان یک فید کانالی در
\fInewsfeeds\fR
پیکربندی می‌شود، به‌طوری که لیست‌های پستی مختلف به عنوان ورودی‌های قیفی (funnel entries) به آن اشاره دارند (پایین‌تر را ببینید)؛
\&\fBnews2mail\fR
انتظار دارد توکن یک مقاله خبری و به دنبال آن دنباله‌ای از نام‌های لیست‌های پستی را دریافت کند.
.PP
\&\fBnews2mail\fR
از فایل پیکربندی
\fIpathetc\fR/news2mail.cf
برای نگاشت نام‌های لیست پستی به نشانی‌های ایمیل استفاده می‌کند.
\&\fBnews2mail\fR
باعث می‌شود عامل انتقال ایمیل (معمولاً
\fBsendmail\fR\c
، همان‌طور که در پارامتر
\fImta\fR
در فایل
\&\fIinn.conf\fR
تنظیم شده است) پیام‌ها را برای تحویل در آینده در صف قرار دهد (تا از حملات محروم‌سازی از سرویس یا DoS ناشی از ارسال‌های انبوه جلوگیری شود). شما باید به صورت دوره‌ای دستور
\f(CW\*(C`sendmail \-q\*(C'\fR
را اجرا کنید تا صف پیام‌ها پردازش شود.
.PP
اگر ایجاد دروازه و پل ارتباطی با نرم‌افزاری مانند Mailman راه‌اندازی می‌شود که خود قابلیت دریافت و ارسال مستقل مقالات خبری را دارد، بهتر است تنها به همین قابلیت اتکا کنید (و دسترسی خواندن و ارسال در گروه خبری را به Mailman بدهید) و اصلاً از
\&\fBnews2mail\fR
استفاده نکنید. این کار بی‌تردید در زمان لازم برای پیکربندی صحیح آن و بررسی حلقه‌های چرخشی احتمالی یا برگشت خوردن پیام‌ها صرفه‌جویی خواهد کرد.
.PP
همچنین راهکار دیگری برای اتصال یک گروه خبری به یک لیست پستی وجود دارد؛ به این صورت که گروه خبری را به یک گروه مدیریت‌شده (moderated) تبدیل کنید و نشانی لیست Mailman را به عنوان نشانی مدیر/ناظر گروه خبری در فایل پیکربندی
\fBmoderators\fR(5)
تنظیم نمایید تا تمامی موارد از طریق Mailman هدایت شوند. در این ساختار، حتی می‌توان از Mailman به عنوان یک رابط نظارت و مدیریت استفاده کرد.
.SH "فایل پیکربندی (CONFIGURATION FILE)"
.IX Header "CONFIGURATION FILE"
قالب فایل پیکربندی ساده است: توضیحات (که با علامت هش
\&\f(CW\*(C`#\*(C'\fR
شروع می‌شوند) و خطوط خالی نادیده گرفته می‌شوند. سایر خطوط دارای دو یا سه فیلد هستند. فیلد نخست، نام لیست است و همان مقداری است که
\fBinnd\fR
از آن استفاده می‌کند (یعنی فیلد site مربوط به مدخل در فایل
\fInewsfeeds\fR).
فیلد دوم، نشانی ایمیل واقعی است که مقاله باید به آن ارسال گردد. فیلد سوم اختیاری است: این فیلد نشانی فرستنده پاکت (envelope-from) را تنظیم می‌کند (برای مثال نشانی یکی از اعضای لیست؛ در صورت عدم تعیین، مقدار پیش‌فرض آن روی کاربر
\&\f(CW\*(C`news\*(C'\fR
قرار می‌گیرد).
.PP
در پیام‌های ایمیل، مقدار فیلد سرآیند
To
شامل نشانی لیست پستی (یعنی فیلد دوم) خواهد بود. علاوه بر این،
\&\fBnews2mail\fR
اغلب فیلدهای سرآیند مقاله را پیش از ارسال از طریق ایمیل حذف می‌کند.
.PP
در فایل
\fInewsfeeds\fR،
فید کانالی باید به شکل زیر باشد:
.PP
.Vb 1
\&    news2mail!:!*:Ac,Tc,Wn*:<pathbin>/news2mail
.Ve
.PP
و برای هر لیست پستی، تنها کافی است مدخلی مانند زیر را به
\fInewsfeeds\fR
اضافه کنید:
.PP
.Vb 3
\&    list\-big\-red\-ants/lists.ucsd.edu\e
\&        :!*,rec.pets.red\-ants\e
\&        :Ap,Tm:news2mail!
.Ve
.PP
لطفاً به استفاده از
\f(CW\*(C`Ap\*(C'\fR
و مستثنی کردن دامنه مالک لیست دقت فرمایید تا لیست پستی از برگشت مجدد پیام‌های تازه‌رسیده به خودش محافظت شود. نام سایت استفاده‌شده در مدخل
\fInewsfeeds\fR
برای یک لیست پستی (در بالا
\&\f(CW\*(C`list\-big\-red\-ants\*(C'\fR)
باید دقیقاً مشابه فیلد نخست در مدخل
\&\fInews2mail.cf\fR
باشد؛ برای مثال:
.PP
.Vb 2
\&    # newsfeeds\-name   list\-to\-address      [list\-sender\-address]
\&    list\-big\-red\-ants  ants@lists.ucsd.edu  news+ants@news.server.org
.Ve
.SH "فایل‌ها (FILES)"
.IX Header "FILES"
.IP \fIpathbin\fR/news2mail 4
.IX Item "pathbin/news2mail"
خود برنامه پرل (Perl) که برای ارسال و تبدیل مقالات خبری به ایمیل به کار می‌رود.
.IP \fIpathetc\fR/news2mail.cf 4
.IX Item "pathetc/news2mail.cf"
فایل پیکربندی که نگاشت‌های لازم برای هدایت مقالات به ایمیل را مشخص می‌کند.
.SH "اشکالات (BUGS)"
.IX Header "BUGS"
برنامه
\&\fBnews2mail\fR
به صورت یک کانال قیفی (funnelled channel) در
\fInewsfeeds\fR
تنظیم شده است، به این معنی که چندین مورد منطبق باید به عنوان یک مورد واحد مدیریت شوند \- و تطابق چند فید قیفی منجر به یک بار فراخوانی این اسکریپت خواهد شد. در نتیجه، از آنجا که تنها یک ایمیل ارسال می‌شود، ارسال‌های مشترک در چند گروه خبری (crossposts) در حال حاضر از لحاظ نشانی
envelope-from
به درستی مدیریت نمی‌شوند (که در این صورت به طور پیش‌فرض روی کاربر
\&\f(CW\*(C`news\*(C'\fR
تنظیم می‌شود).
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
اسکریپت
\&\fBnews2mail\fR
در سال ۱۹۹۸ توسط
Brian Kantor
نوشته شد. این صفحه راهنما توسط
James Brister
نگاشته شده و توسط
Julien Elie
به فرمت
POD
تبدیل گردید. فیلد اختیاری سوم در
\fInews2mail.cf\fR
نیز در سال ۲۰۰۸ توسط
D.\ Stussy
اضافه شد.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\fBinnd\fR(8)،
\fBnewsfeeds\fR(5).