'\" t
.\"     Title: auto-multiple-choice-export
.\"    Author: Bienvenue Alexis[FAMILY Given] <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.ja \- صدور نتایج و نمرات آزمون‌های چندگزینه‌ای 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
نمرات و نتایج آزمون‌های چندگزینه‌ای AMC را صادر (اکسپورت) می‌کند\&.
.PP
\fB\-\-data \fR\fB\fIproject\-data\-dir\fR\fR
.RS 4
دایرکتوری حاوی فایل‌های داده را مشخص می‌کند (برای نمونه به
\fBauto-multiple-choice-meptex\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
گزینه‌ای را برای ماژول انتخاب‌شده به صورت
\fIkey=value\fR
مشخص می‌کند (گزینه‌های قابل استفاده برای هر ماژول در بخش ماژول‌ها شرح داده شده‌اند)\&. برای تعیین چندین گزینه، می‌توان از
\fB\-\-option\-out\fR
(یا
\fB\-\-option\fR)
چندین بار استفاده کرد\&.
.RE
.PP
\fB\-\-sort \fR\fB\fIsort\-type\fR\fR
.RS 4
نام شرکت‌کنندگان را بر اساس
\fIsort\-type\fR
مرتب می‌کند\&. اگر
\fIsort\-type\fR
برابر با
\fBl\fR
باشد، از شماره خط در فایل فهرست شرکت‌کنندگان برای مرتب‌سازی استفاده می‌شود\&. اگر
\fIsort\-type\fR
برابر با
\fBm\fR
باشد، از نمره (و در صورت برابری نمرات، از نام) برای مرتب‌سازی استفاده می‌شود\&. اگر
\fIsort\-type\fR
برابر با
\fBi\fR
باشد، از شماره دانش‌آموزی/داوطلب برای مرتب‌سازی استفاده می‌شود\&. اگر
\fIsort\-type\fR
برابر با
\fBn\fR
باشد، از نام (و در صورت یکسان بودن، از شماره خط در فهرست) برای مرتب‌سازی استفاده می‌شود\&.
.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
\fBnom\fR
.RS 4
نام آزمون را تعیین می‌کند تا در ابتدای برگه درج شود\&.
.RE
.PP
\fBcode\fR
.RS 4
نام کوتاه آزمون را جهت استفاده به عنوان نام برگه (زبانه) تعیین می‌کند\&.
.RE
.PP
\fBcolumns\fR
.RS 4
فهرست ستون‌هایی را که باید برای هر شرکت‌کننده اضافه شوند تعیین می‌کند\&. مقدار پیش‌فرض
\fIstudent\&.key,student\&.name\fR
است\&.
.RE
.PP
\fBstats\fR
.RS 4
در صورت تنظیم با مقدار
\fBtrue\fR،
جدول آماری سؤالات اضافه خواهد شد\&.
.RE
.PP
\fBstatsindic\fR
.RS 4
در صورت تنظیم با مقدار
\fBtrue\fR،
جدول آماری سؤالات بدون نمره (راهنما/اختیاری) اضافه خواهد شد\&.
.RE
.SS "CSV"
.PP
با مشخص کردن
«\fB\-\-module CSV\fR»،
یک فایل CSV ایجاد می‌شود\&. گزینه‌های زیر برای این ماژول پشتیبانی می‌شوند:
.PP
\fBcolumns\fR
.RS 4
فهرست ستون‌هایی را که باید برای هر شرکت‌کننده اضافه شوند تعیین می‌کند\&. مقدار پیش‌فرض
\fIstudent\&.copy,student\&.key,student\&.name\fR
است\&.
.RE
.PP
\fBdecimal\fR
.RS 4
ممیز یا جداکننده اعشار را تعیین می‌کند (پیش‌فرض نقطه «\&.» است)\&.
.RE
.PP
\fBencodage\fR
.RS 4
کدگذاری (انکودینگ) مورد استفاده برای خروجی را تعیین می‌کند (پیش‌فرض utf\-8 است)\&.
.RE
.PP
\fBseparateur\fR
.RS 4
کاراکتر جداکننده میان ستون‌ها را مشخص می‌کند (پیش‌فرض کاما «,» است)\&.
.RE
.PP
\fBentoure\fR
.RS 4
کاراکتر مورد استفاده برای محصور کردن رشته‌ها را مشخص می‌کند (پیش‌فرض علامت نقل‌قول دوتایی «"» است)\&.
.RE
.PP
\fBticked\fR
.RS 4
اگر خالی نباشد، ستون‌هایی با نام‌هایی که با «:CHECKED» شروع می‌شوند اضافه خواهند شد تا نشان دهند چه کادرهایی در هر پاسخ‌نامه علامت خورده‌اند\&. این قابلیت برای برنامه‌های خارجی جهت استخراج اطلاعات کادرهای علامت‌خورده در مواردی که نمرات کافی نیستند کاربرد دارد\&. اگر کادرهای ۳ و ۴ علامت خورده باشند، در صورت تعیین مقدار
\fB01\fR
نتیجه به صورت 0;0;1;1;0 و در صورت تعیین مقدار
\fBAB\fR
نتیجه به صورت CD خواهد بود\&.
.RE
.SS "List"
.PP
با مشخص کردن
«\fB\-\-module List\fR»،
یک فایل PDF شامل فهرست نمرات شرکت‌کنندگان ایجاد می‌شود\&. گزینه‌های زیر برای این ماژول پشتیبانی می‌شوند:
.PP
\fBpagesize\fR
.RS 4
اندازه صفحه را مشخص می‌کند\&. مقدار پیش‌فرض
\fBa4\fR
است\&.
.RE
.PP
\fBnom\fR
.RS 4
نام آزمون را تعیین می‌کند تا در بالای صفحه چاپ شود\&.
.RE
.PP
\fBncols\fR
.RS 4
تعداد ستون‌ها را مشخص می‌کند\&. مقدار پیش‌فرض 2 است\&.
.RE
.PP
\fBdecimal\fR
.RS 4
ممیز یا جداکننده اعشار را تعیین می‌کند (پیش‌فرض نقطه «\&.» است)\&.
.RE
.SH "نویسندگان (AUTHORS)"
.PP
\fBBienvenue Alexis[FAMILY Given]\fR <\&paamc@passoire.fr\&>
.RS 4
نویسنده اصلی
.RE
.PP
\fBSarkar Anirvan[FAMILY Given]\fR
.RS 4
نویسنده و ویرایشگر
.RE
.PP
\fBKagotani Hiroto[FAMILY Given]\fR
.RS 4
ویرایشگر
.RE
.PP
\fBBr\('ed\('eric Br\('eal[FAMILY Given]\fR
.RS 4
نویسنده و ویرایشگر
.RE
.PP
\fBB\('erard Jean[FAMILY Given]\fR
.RS 4
ترجمه از فرانسوی به انگلیسی
.RE
.PP
\fBKhaznadar Georges[FAMILY Given]\fR
.RS 4
ترجمه از فرانسوی به انگلیسی
.RE
.PP
\fBKagotani Hiroto[FAMILY Given]\fR
.RS 4
ترجمه از انگلیسی به ژاپنی
.RE
.SH "کپی‌رایت (COPYRIGHT)"
.br
حق نشر \(co 2008-2018 Alexis Bienven\(:ue
.br
.PP
این سند بر اساس شرایط مجوز عمومی همگانی گنو (GNU GPL) نسخه ۲ یا بالاتر قابل استفاده است.
.sp