'\" t
.\"     Title: auto-multiple-choice-mailing
.\"    Author: Alexis Bienven\(:ue <paamc@passoire.fr>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2025-04-17
.\"    Manual: Auto Multiple Choice
.\"    Source: Auto Multiple Choice 1.7.0
.\"  Language: Persian
.\"
.TH "AUTO\-MULTIPLE\-CHOI" "1" "2025-04-17" "Auto Multiple Choice 1\&.7\&.0" "Auto Multiple Choice"
.\" -----------------------------------------------------------------
.\" * 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)"
auto-multiple-choice-mailing \- ارسال نتایج و برگه‌های آزمون حاشیه‌نویسی‌شده به دانشجویان از طریق ایمیل
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBauto\-multiple\-choice\fR\ 'u
\fBauto\-multiple\-choice\fR mailing [\-\-xmlargs\ \fIargs\&.xml\fR] \-\-project\ \fIproject\-dir\fR \-\-students\-list\ \fIstudents\-list\&.csv\fR [\-\-list\-encoding\ \fIencoding\fR] \-\-email\-column\ \fIcol\fR \-\-sender\ \fIsender\-email\fR \-\-subject\ \fIsubject\fR \-\-text\ \fIemail\-body\fR [\-\-text\-content\-type\ \fIcontent\-type\fR] [\-\-debug\ \fIfile\&.log\fR] [\fItransport\ arguments\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBauto\-multiple\-choice mailing\fR
برگه‌های پاسخ تصحیح و حاشیه‌نویسی‌شده با فرمت PDF را از طریق ایمیل برای دانشجویان ارسال می‌کند\&. نشانی‌های ایمیل از فایل فهرست دانشجویان خوانده می‌شوند\&.
.PP
\fB\-\-project \fR\fB\fIproject\-dir\fR\fR
.RS 4
دایرکتوری پروژه را مشخص می‌کند\&.
.RE
.PP
\fB\-\-students\-list \fR\fB\fIstudents\-list\&.csv\fR\fR
.RS 4
نام فایل فهرست دانشجویان را تعیین می‌کند\&.
.RE
.PP
\fB\-\-list\-encoding \fR\fB\fIencoding\fR\fR
.RS 4
کدگذاری فایل
\fIstudents\-list\&.csv\fR
را انتخاب می‌کند (پیش‌فرض utf\-8 است)\&.
.RE
.PP
\fB\-\-email\-column \fR\fB\fIcol\fR\fR
.RS 4
نام ستون حاوی نشانی‌های ایمیل دانشجویان در فایل فهرست دانشجویان را تعیین می‌کند\&.
.RE
.PP
\fB\-\-sender \fR\fB\fIsender\-email\fR\fR
.RS 4
ایمیل فرستنده را تنظیم می‌کند\&.
.RE
.PP
\fB\-\-cc \fR\fB\fIcc\-email\-address\fR\fR
.RS 4
نشانی ایمیل رونوشت (CC) را تعیین می‌کند\&.
.RE
.PP
\fB\-\-bcc \fR\fB\fIbcc\-email\-address\fR\fR
.RS 4
نشانی ایمیل رونوشت پنهان (BCC) را تعیین می‌کند\&.
.RE
.PP
\fB\-\-subject \fR\fB\fIsubject\fR\fR
.RS 4
موضوع ایمیل‌های ارسالی را تعیین می‌کند\&.
.RE
.PP
\fB\-\-text \fR\fB\fIemail\-body\fR\fR
.RS 4
متن بدنه ایمیل‌های ارسالی را مشخص می‌کند\&.
.RE
.PP
\fB\-\-text\-content\-type \fR\fB\fIcontent\-type\fR\fR
.RS 4
نوع محتوای (content\-type) متن ایمیل را تعیین می‌کند\&.
\fIcontent\-type\fR
می‌تواند
\fBtext/plain\fR
یا
\fBtext/html\fR
باشد\&.
.RE
.PP
\fB\-\-attach \fR\fB\fIfilename\fR\fR
.RS 4
فایل
\fIfilename\fR
را به‌عنوان پیوست به تمام ایمیل‌های ارسالی اضافه می‌کند\&. برای پیوست کردن چندین فایل، از این گزینه چند بار استفاده کنید\&.
.RE
.PP
\fB\-\-transport \fR\fB\fItransport\fR\fR
.RS 4
روش یا پروتکل انتقال (transport) مورد استفاده را مشخص می‌کند\&.
\fItransport\fR
می‌تواند
\fBsendmail\fR
یا
\fBSMTP\fR
باشد\&.
.RE
.PP
\fB\-\-debug \fR\fB\fIfile\&.log\fR\fR
.RS 4
یک فایل برای ذخیره اطلاعات اشکال‌زدایی (دیباگ) مشخص می‌کند\&.
.RE
.PP
\fB\-\-delay \fR\fB\fItime\fR\fR
.RS 4
یک تأخیر به میزان
\fItime\fR
ثانیه بین هر ارسال تنظیم می‌کند\&.
.RE
.SH "آرگومان‌های روش انتقال (TRANSPORT ARGUMENTS)"
.PP
بسته به مقدار استفاده‌شده برای آرگومان
\fItransport\fR،
آرگومان‌های زیر را می‌توان اضافه کرد:
.SS "روش انتقال sendmail (Transport sendmail)"
.PP
\fB\-\-sendmail\-path \fR\fB\fIpath\fR\fR
.RS 4
مسیر دستور
\fBsendmail\fR
را تعیین می‌کند (پیش‌فرض
/usr/sbin/sendmail
است)\&.
.RE
.SS "روش انتقال SMTP (Transport SMTP)"
.PP
\fB\-\-smtp\-host \fR\fB\fIhost\fR\fR
.RS 4
نام میزبان SMTP را تعیین می‌کند (پیش‌فرض
\fBsmtp\fR
است)\&.
.RE
.PP
\fB\-\-smtp\-port \fR\fB\fIport\fR\fR
.RS 4
پورت مورد استفاده را تنظیم می‌کند (مقدار پیش‌فرض 25 است)\&.
.RE
.PP
\fB\-\-smtp\-ssl \fR\fB\fImode\fR\fR
.RS 4
حالت امنیتی اتصال SMTP را تعیین می‌کند\&. گزینه
\fImode\fR
می‌تواند
ssl،
starttls
یا
0
(ناامن) باشد\&.
.RE
.PP
\fB\-\-smtp\-user \fR\fB\fIuser\fR\fR
.RS 4
نام کاربری را برای احراز هویت در SMTP تنظیم می‌کند\&.
.RE
.PP
\fB\-\-smtp\-passwd\-file \fR\fB\fIfile\fR\fR
.RS 4
مسیر فایلی حاوی رمز عبور (در خط اول فایل) را برای احراز هویت در SMTP مشخص می‌کند\&.
.RE
.SH "آرگومان‌ها در یک فایل XML (ARGUMENTS IN A XML FILE)"
.PP
برای جلوگیری از مشکلات کدگذاری، می‌توان برخی از آرگومان‌ها را در یک فایل XML قرار داد و از آرگومان
\fB\-\-xmlargs \fR\fB\fIfile\&.xml\fR\fR
به‌عنوان اولین آرگومان دستور استفاده کرد\&. در اینجا نمونه‌ای از چنین فایلی آورده شده است:
.sp
.if n \{\
.RS 4
.\}
.nf
<?xml version="1\&.0" encoding="UTF\-8"?>
<arguments>
  <arg>\-\-sender</arg><arg>Bienven\(:ue &lt;paamc@passoire\&.fr&gt;</arg>
  <arg>\-\-text</arg><arg>Voil\(`a votre copie corrig\('ee</arg>
  <arg>\-\-subject</arg><arg>QCM</arg>
</arguments>
.fi
.if n \{\
.RE
.\}
.SH "نویسندگان (AUTHORS)"
.PP
\fBAlexis Bienven\(:ue\fR <\&paamc@passoire.fr\&>
.RS 4
نویسنده اصلی
.RE
.PP
\fBAnirvan Sarkar\fR
.RS 4
نویسنده و ویراستار
.RE
.PP
\fBHiroto Kagotani\fR
.RS 4
ویراستار
.RE
.PP
\fBFr\('ed\('eric Br\('eal\fR
.RS 4
نویسنده و ویراستار
.RE
.PP
\fBJean B\('erard\fR
.RS 4
ترجمه از فرانسوی
.RE
.PP
\fBGeorges Khaznadar\fR
.RS 4
ترجمه از فرانسوی
.RE
.SH "کپی‌رایت (COPYRIGHT)"
.br
Copyright \(co 2008-2025 Alexis Bienven\(:ue
.br
.PP
این سند بر اساس شرایط مجوز عمومی همگانی گنو (GNU General Public License)، نسخه ۲ یا بالاتر قابل استفاده است\&.
.sp