'\" t
.\"     Title: auto-multiple-choice-export
.\"    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-export \- صدور نتایج و نمرات آزمون‌های چندگزینه‌ای AMC به قالب‌های مختلف
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBauto\-multiple\-choice\fR\ 'u
\fBauto\-multiple\-choice\fR export \-\-data\ \fIproject\-data\-dir\fR \-\-module\ \fImodule\fR \-\-fich\-noms\ \fIstudents\-list\&.csv\fR [\-\-noms\-encodage\ \fIlist\-encoding\fR] \-\-o\ \fIoutput\-file\fR
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBauto\-multiple\-choice export\fR
نمرات یک آزمون Auto Multiple Choice را صادر می‌کند\&.
.PP
\fB\-\-data \fR\fB\fIproject\-data\-dir\fR\fR
.RS 4
پوشه‌ای را که فایل‌های داده در آن قرار دارند مشخص می‌کند (به عنوان مثال
\fBauto-multiple-choice-prepare\fR(1)
را ببینید)\&.
.RE
.PP
\fB\-\-module \fR\fB\fImodule\fR\fR
.RS 4
ماژولی را برای صدور انتخاب می‌کند\&. برای ماژول‌های موجود در توزیع استاندارد AMC به بخش زیر مراجعه کنید\&.
.RE
.PP
\fB\-\-fich\-noms \fR\fB\fIstudents\-list\&.csv\fR\fR
.RS 4
فایل فهرست دانش‌آموزان را مشخص می‌کند\&.
.RE
.PP
\fB\-\-noms\-encodage \fR\fB\fIlist\-encoding\fR\fR
.RS 4
کدگذاری فایل
\fIstudents\-list\&.csv\fR
را تعیین می‌کند (پیش‌فرض utf\-8 است)\&.
.RE
.PP
\fB\-\-o \fR\fB\fIoutput\-file\fR\fR
.RS 4
نام فایل خروجی را مشخص می‌کند\&.
.RE
.PP
\fB\-\-option\-out \fR\fB\fIoptions\fR\fR
.RS 4
گزینه‌ای را برای ماژول انتخاب‌شده در قالب
key=value
تعیین می‌کند (گزینه‌های ممکن برای هر ماژول را در ادامه ببینید)\&. برای تعیین چندین گزینه، از
\fB\-\-option\fR
به دفعات استفاده کنید\&.
.RE
.PP
\fB\-\-sort \fR\fB\fIsort\-type\fR\fR
.RS 4
نام دانش‌آموزان را بر اساس
\fIsort\-type\fR
مرتب می‌کند\&. اگر
\fIsort\-type\fR
برابر با
l
باشد، از شماره خط فایل فهرست دانش‌آموزان برای مرتب‌سازی استفاده می‌شود\&. اگر
\fIsort\-type\fR
برابر با
m
باشد، از نمره (و در صورت تساوی نمرات، از نام) برای مرتب‌سازی استفاده می‌شود\&. اگر
\fIsort\-type\fR
برابر با
i
باشد، از شماره دانش‌آموزی برای مرتب‌سازی استفاده می‌شود\&. اگر
\fIsort\-type\fR
برابر با
n
باشد، از نام برای مرتب‌سازی استفاده می‌شود (یا در صورت یکسان بودن، از شماره خط در فهرست دانش‌آموزان)\&.
.RE
.PP
\fB\-\-useall \fR\fB\fIall\fR\fR
.RS 4
اگر
\fIall\fR
برابر با
0
یا خالی باشد، فقط دانش‌آموزانی که برگه پاسخ اسکن‌شده دارند در خروجی ظاهر می‌شوند\&. اگر
\fIall\fR
برابر با
1
باشد، همه دانش‌آموزان موجود در فهرست دانش‌آموزان در خروجی ظاهر خواهند شد\&.
.RE
.SH "ماژول‌ها (MODULES)"
.SS "OpenDocument"
.PP
با «\fB\-\-module ods\fR»، یک سند OpenDocument (برای مثال جهت استفاده در OpenOffice یا LibreOffice) تولید می‌شود\&. گزینه‌های زیر شناخته‌شده هستند:
.PP
nom
.RS 4
نامی برای آزمون مشخص می‌کند که در ابتدای برگه نوشته می‌شود\&.
.RE
.PP
code
.RS 4
نام کوتاهی برای آزمون مشخص می‌کند که به عنوان نام برگه (tab) استفاده می‌شود\&.
.RE
.PP
columns
.RS 4
فهرست ستون‌هایی را که باید برای هر دانش‌آموز اضافه شوند تعیین می‌کند\&.
.sp
مقدار پیش‌فرض
student\&.key,student\&.name
است\&.
.RE
.PP
stats
.RS 4
با یک مقدار درست (true)، جدولی شامل آمار برای تمام سؤالات اضافه خواهد شد\&.
.RE
.PP
statsindic
.RS 4
با یک مقدار درست (true)، جدولی شامل آمار برای تمام سؤالات راهنما/شاخص اضافه خواهد شد\&.
.RE
.SS "CSV"
.PP
با «\fB\-\-module CSV\fR»، یک فایل CSV تولید می‌شود\&. گزینه‌های زیر شناخته‌شده هستند:
.PP
columns
.RS 4
فهرست ستون‌هایی را که باید برای هر دانش‌آموز اضافه شوند تعیین می‌کند\&.
.sp
مقدار پیش‌فرض
student\&.copy,student\&.key,student\&.name
است\&.
.RE
.PP
decimal
.RS 4
نقطه اعشار را تعیین می‌کند (پیش‌فرض نقطه است)\&.
.RE
.PP
encodage
.RS 4
کدگذاری مورد استفاده برای خروجی را تعیین می‌کند (پیش‌فرض utf\-8 است)\&.
.RE
.PP
separateur
.RS 4
نویسه مورد استفاده میان ستون‌ها را تعیین می‌کند (پیش‌فرض کاما است)\&.
.RE
.PP
entoure
.RS 4
نویسه مورد استفاده برای احاطه کردن رشته‌ها را تعیین می‌کند (پیش‌فرض علامت نقل‌قول دوگانه است)\&.
.RE
.PP
ticked
.RS 4
اگر خالی نباشد، ستون‌های اضافی (با پیشوند «CHECKED:») اضافه می‌شوند تا تمام خانه‌های علامت‌خورده در تمام برگه‌ها را نشان دهند\&. این مورد می‌تواند توسط یک برنامه خارجی استفاده شود تا در صورتی که نمرات کافی نباشند، تمام خانه‌های علامت‌خورده بازیابی شوند\&. از مقدار
01
برای دریافت 0;0;1;1;0 در صورت علامت خوردن خانه‌های ۳ و ۴، و از مقدار
AB
برای دریافت CD در صورت علامت خوردن خانه‌های ۳ و ۴ استفاده کنید\&.
.RE
.SS "List"
.PP
با «\fB\-\-module List\fR»، یک فایل PDF با فهرستی از نمرات تمام دانش‌آموزان تولید می‌شود\&. گزینه‌های زیر شناخته‌شده هستند:
.PP
pagesize
.RS 4
اندازه صفحه\&. مقدار پیش‌فرض
a4
است\&.
.RE
.PP
nom
.RS 4
نام آزمون را تعیین می‌کند که در بالای صفحه چاپ می‌شود\&.
.RE
.PP
ncols
.RS 4
تعداد ستون‌ها\&. مقدار پیش‌فرض 2 است\&.
.RE
.PP
decimal
.RS 4
نقطه اعشار را تعیین می‌کند (پیش‌فرض نقطه است)\&.
.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
کپی‌رایت \(co 2008-2025 Alexis Bienven\(:ue
.br
.PP
این سند می‌تواند بر اساس شرایط مجوز عمومی همگانی گنو (GNU General Public License) نسخه ۲ یا بالاتر استفاده شود.
.sp