'\" t
.\"     Title: auto-multiple-choice-annotate
.\"    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-annotate \- یادداشت‌نویسی و تصحیح بر روی برگه‌های پاسخ‌نامه پس از نمره‌دهی برای آزمون‌های چندگزینه‌ای AMC\&.
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBauto\-multiple\-choice\fR\ 'u
\fBauto\-multiple\-choice\fR annotate \-\-project\ \fIproject\-dir\fR \-\-names\-file\ \fIstudents\&.csv\fR [annotation\ options...]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBauto\-multiple\-choice annotate\fR
اسکن‌های برگه‌های امتحانی را با نمرات تمام سوالات، نمره کل و تراز/نمره نهایی یادداشت‌نویسی و تصحیح کرده و در قالب فایل‌های PDF (یک فایل برای هر دانش‌آموز یا یک فایل منفرد) خروجی می‌دهد\&.
.SS "گزینه‌های عمومی (General options)"
.PP
\fB\-\-project \fR\fB\fIproject\-dir\fR\fR
.RS 4
نام یا دایرکتوری پروژه را تعیین می‌کند\&.
.RE
.PP
\fB\-\-data \fR\fB\fIproject\-data\-dir\fR\fR
.RS 4
دایرکتوری محل قرارگیری فایل‌های داده را مشخص می‌کند (مقدار پیش‌فرض
\fIproject\-dir\fR/data
است)\&.
.RE
.PP
\fB\-\-pdf\-dir \fR\fB\fIpdf\-dir\fR\fR
.RS 4
دایرکتوری PDF پروژه را برای ذخیره اسکن‌های تصحیح‌شده مشخص می‌کند (مقدار پیش‌فرض
\fIproject\-dir\fR/cr/corrections/pdf
است)\&.
.RE
.PP
\fB\-\-names\-file \fR\fB\fIstudents\-list\&.csv\fR\fR
.RS 4
نام فایل فهرست دانش‌آموزان را تعیین می‌کند\&.
.RE
.PP
\fB\-\-names\-encoding \fR\fB\fIencoding\fR\fR
.RS 4
کدگذاری فایل
\fIstudents\-list\&.csv\fR
را انتخاب می‌کند (پیش‌فرض utf\-8 است)\&.
.RE
.PP
\fB\-\-association\-key \fR\fB\fIkey\fR\fR
.RS 4
کلید (نام ستون در فایل فهرست دانش‌آموزان) مورد استفاده برای انتساب را تعیین می‌کند\&. مقدار پیش‌فرض از روی مقداری که در عمل برای انتساب استفاده شده در پایگاه داده ذخیره می‌شود، بنابراین نیازی به استفاده از این گزینه نیست\&.
.RE
.PP
\fB\-\-subject \fR\fB\fIsubject\&.pdf\fR\fR
.RS 4
مسیر فایل PDF سوالات را تعیین می‌کند (پیش‌فرض
\fIproject\-dir\fR/DOC\-sujet\&.pdf
است)\&.
.RE
.PP
\fB\-\-compose \fR\fB\fImode\fR\fR
.RS 4
در صورتی که می‌خواهید صفحاتی از برگه سوالات را که فاقد کادر برای پر کردن هستند اضافه کنید (به عنوان مثال، صفحات سوالات پیش از پاسخ‌نامه تصحیح‌شده)، از این گزینه استفاده کنید\&. هنگامی که
\fImode\fR
برابر با 1 باشد، صفحات از برگه سوالات گرفته شده و بر اساس پاسخ‌های دانش‌آموز (مشابه با برگه پاسخ‌نامه) پر یا خالی می‌شوند و همان علامت‌های تصحیح که روی برگه پاسخ‌نامه کشیده می‌شوند، رسم خواهند شد\&. هنگامی که حالت برابر با 2 باشد، صفحات از پاسخ‌نامه تصحیح‌شده (کلید آزمون) گرفته می‌شوند (بنابراین پاسخ‌های تیک‌خورده همان پاسخ‌های صحیح هستند) و هیچ علامت تصحیحی رسم نمی‌شود\&.
.RE
.PP
\fB\-\-corrected \fR\fB\fIcorrected\&.pdf\fR\fR
.RS 4
مسیر فایل PDF پاسخ‌نامه تصحیح‌شده را تعیین می‌کند (پیش‌فرض
\fIproject\-dir\fR/DOC\-corrected\&.pdf
است)\&. در صورت عدم وجود، این فایل با استفاده از مقادیر گزینه‌های
\fB\-\-n\-copies\fR،
\fB\-\-with\fR،
\fB\-\-filter\fR
و
\fB\-\-filtered\-source\fR
ساخته خواهد شد\&.
.RE
.PP
\fB\-\-darkness\-threshold \fR\fB\fIt\fR\fR
.RS 4
آستانه تیرگی را تنظیم می‌کند\&. مقدار پیش‌فرض از روی مقداری که در عمل برای نمره‌دهی استفاده شده در پایگاه داده ذخیره می‌شود، بنابراین نیازی به استفاده از این گزینه نیست\&.
.RE
.PP
\fB\-\-darkness\-threshold\-up \fR\fB\fIupper_t\fR\fR
.RS 4
حد بالای آستانه تیرگی را تنظیم می‌کند\&. مقدار پیش‌فرض از روی مقداری که در عمل برای نمره‌دهی استفاده شده در پایگاه داده ذخیره می‌شود، بنابراین نیازی به استفاده از این گزینه نیست\&.
.RE
.PP
\fB\-\-csv\-build\-name \fR\fB\fIname\-model\fR\fR
.RS 4
الگوی ساخت نام دانش‌آموزان از روی فایل فهرست دانش‌آموزان را تعیین می‌کند\&. مقدار پیش‌فرض \*(Aq(nom|surname) (prenom|name)\*(Aq است، به طوری که نام با استفاده از محتوای ستون
nom
(یا در صورت عدم وجود ستون
nom
، ستون
surname
) و به دنبال آن محتوای ستون
prenom
(یا ستون
name
) ساخته می‌شود تا نتیجه برای فایل‌های CSV ساده به زبان فرانسوی یا انگلیسی مناسب باشد\&.
.RE
.PP
\fB\-\-id\-file \fR\fB\fIids\&.txt\fR\fR
.RS 4
نام فایلی را مشخص می‌کند که شناسه‌های برگه‌های مورد نظر برای تصحیح در آن قرار دارند (یک شناسه در هر خط؛ در صورت غیرفعال بودن حالت فتوکپی، شماره دانش‌آموز و در صورت فعال بودن حالت فتوکپی، به صورت
\fIstudent\fR:\fIcopy\fR
خواهد بود)\&. اگر هیچ فایلی داده نشود، تمامی برگه‌ها یادداشت‌نویسی و تصحیح خواهند شد\&.
.RE
.PP
\fB\-\-debug \fR\fB\fIfile\&.log\fR\fR
.RS 4
فایلی را برای ذخیره اطلاعات اشکال‌زدایی مشخص می‌کند\&.
.RE
.SS "گزینه‌های خروجی PDF (PDF output options)"
.PP
\fB\-\-single\-output\fR
.RS 4
در صورتی که به تمامی برگه‌های تصحیح‌شده در قالب یک فایل PDF منفرد نیاز دارید، از این گزینه استفاده کنید\&. رفتار پیش‌فرض، ساخت یک فایل PDF مجزا به ازای هر دانش‌آموز است\&.
.RE
.PP
\fB\-\-sort \fR\fB\fIs\fR\fR
.RS 4
کلید مرتب‌سازی را تعیین می‌کند (تنها زمانی که از
\fB\-\-single\-output\fR
استفاده شود کاربرد دارد): از مقادیر زیر استفاده کنید:
.PP
l
.RS 4
برای حفظ ترتیب دانش‌آموزان مطابق با فایل فهرست دانش‌آموزان\&.
.RE
.PP
m
.RS 4
برای مرتب‌سازی دانش‌آموزان بر اساس نمراتشان\&.
.RE
.PP
i
.RS 4
برای مرتب‌سازی دانش‌آموزان بر اساس شناسه برگه\&.
.RE
.PP
n
.RS 4
برای مرتب‌سازی دانش‌آموزان بر اساس نام‌هایشان\&.
.RE
.RE
.PP
\fB\-\-filename\-model \fR\fB\fImodel\fR\fR
.RS 4
الگوی نام فایل را برای فایل‌های PDF تصحیح‌شده تعیین می‌کند\&. در این الگو، برخی عبارت‌ها جایگزین خواهند شد:
.PP
(ID)
.RS 4
با نام دانش‌آموز جایگزین می‌شود (به
\fB\-\-csv\-build\-name\fR
مراجعه کنید)\&.
.RE
.PP
(N)
.RS 4
با شماره دانش‌آموز جایگزین می‌شود\&.
.RE
.PP
(\fICOL\fR)
.RS 4
با مقدار ستون
\fICOL\fR
در فهرست دانش‌آموزان برای دانش‌آموز مربوطه جایگزین می‌شود\&.
.RE
.sp
مقدار پیش‌فرض \*(Aq(N)\-(ID)\&.pdf\*(Aq است\&.
.RE
.SS "گزینه‌های فایل منبع (Source file options)"
.PP
این گزینه‌ها زمانی استفاده می‌شوند که مسیر
\fB\-\-corrected\fR
به فایلی اشاره کند که وجود ندارد، تا امکان ساخت مجدد آن فایل فراهم شود\&.
.PP
\fB\-\-src \fR\fB\fImcq\-source\-file\fR\fR\fB \-\-n\-copies \fR\fB\fIn\fR\fR\fB \-\-with \fR\fB\fIlatex\-engine\fR\fR\fB \-\-filter \fR\fB\fIfilter\-name\fR\fR\fB \-\-filtered\-source \fR\fB\fIfs\&.tex\fR\fR
.RS 4
به
\fBauto-multiple-choice-prepare\fR(1)
مراجعه کنید\&.
.RE
.SS "گزینه‌های اسکن‌های تعبیه‌شده (Options for embedded scans)"
.PP
در صورت وجود، تصاویر اسکن‌شده در فایل PDF تصحیح‌شده تعبیه (Embed) می‌شوند\&. گزینه‌های زیر کیفیت اسکن‌های تعبیه‌شده را به منظور کاهش حجم فایل نهایی کنترل می‌کنند\&.
.PP
\fB\-\-embedded\-max\-size \fR\fB\fImaxsize\fR\fR
.RS 4
حداکثر اندازه تصاویر اسکن را تعیین می‌کند (در قالب
\fIwidth\fRx\fIheight\fR،
بر حسب پیکسل)\&. مقدار پیش‌فرض یک رشته خالی است که به معنی عدم محدودیت اندازه است\&. اسکن‌های بزرگتر، پیش از قرار گرفتن در فایل تصحیح‌شده کوچک خواهند شد\&.
.RE
.PP
\fB\-\-embedded\-format \fR\fB\fIformat\fR\fR
.RS 4
فرمت گنجاندن اسکن‌ها را تعیین می‌کند:
\fIjpeg\fR
یا
\fIpng\fR\&.
.RE
.PP
\fB\-\-embedded\-jpeg\-quality \fR\fB\fIquality\fR\fR
.RS 4
کیفیت JPEG (از 1 تا 100) را برای اسکن‌های تعبیه‌شده با فرمت jpeg مشخص می‌کند\&.
.RE
.SS "گزینه‌های یادداشت‌نویسی و تصحیح (Annotation options)"
.PP
این گزینه‌ها نوع یادداشت‌ها و علامت‌های تصحیحی را که باید رسم شوند کنترل می‌کنند\&.
.PP
\fB\-\-font\-size \fR\fB\fIfs\fR\fR
.RS 4
اندازه قلم را بر حسب پوینت برای یادداشت‌ها تعیین می‌کند\&.
.RE
.PP
\fB\-\-text\-color \fR\fB\fIcolor\fR\fR
.RS 4
رنگ متن را برای یادداشت‌ها مشخص می‌کند\&. مقدار پیش‌فرض
\fIred\fR
(قرمز) است\&.
.RE
.PP
\fB\-\-verdict \fR\fB\fIheader\fR\fR
.RS 4
سربرگ متنی را که باید در صفحه اول هر یک از برگه‌های دانش‌آموزان چاپ شود تعیین می‌کند\&. این متن می‌تواند شامل نویسه‌های بازگشت به سر خط (CR) برای سربرگ‌های چندخطی باشد\&. برخی دنباله‌ها در آن جایگزین خواهند شد:
.PP
%S
.RS 4
با نمره کل دانش‌آموز جایگزین می‌شود\&.
.RE
.PP
%M
.RS 4
با حداکثر نمره کل ممکن جایگزین می‌شود\&.
.RE
.PP
%s
.RS 4
با تراز/نمره ثبت‌شده دانش‌آموز جایگزین می‌شود\&.
.RE
.PP
%m
.RS 4
با حداکثر تراز/نمره ممکن جایگزین می‌شود\&.
.RE
.PP
%(ID)
.RS 4
با نام دانش‌آموز جایگزین می‌شود\&.
.RE
.PP
%(\fICOL\fR)
.RS 4
با مقدار ستون
\fICOL\fR
در فهرست دانش‌آموزان برای دانش‌آموز مربوطه جایگزین می‌شود\&.
.RE
.RE
.PP
\fB\-\-position \fR\fB\fIpos\fR\fR
.RS 4
موقعیتی را که نمرات سوالات در آن نوشته می‌شوند تعیین می‌کند:
.PP
marge
.RS 4
نمرات در حاشیه سمت چپ نوشته خواهند شد\&.
.RE
.PP
marges
.RS 4
نمرات در نزدیک‌ترین حاشیه (چپ یا راست) نوشته خواهند شد\&.
.RE
.PP
case
.RS 4
نمرات در نزدیکی کادرهای پاسخ نوشته خواهند شد\&.
.RE
.PP
none
.RS 4
نمرات نوشته نخواهند شد\&.
.RE
.RE
.PP
\-\-verdict\-question \fIperl\-expression\fR
.RS 4
متنی را که باید در کنار تمام سوالات چاپ شود، از طریق یک عبارت پرل (Perl) که باید ارزیابی شود تعیین می‌کند (اگر به یک متن ساده نیاز دارید، کافی است آن را داخل
"
قرار دهید)\&. برخی دنباله‌ها پیش از ارزیابی در آن جایگزین می‌شوند:
.PP
%S
.RS 4
با نمره دانش‌آموز برای این سوال جایگزین می‌شود\&.
.RE
.PP
%M
.RS 4
با حداکثر نمره ممکن برای این سوال جایگزین می‌شود\&.
.RE
.PP
%s
.RS 4
مشابه
%S
است، اما تا
\fInc\fR
رقم با معنی گرد می‌شود (به گزینه
\fB\-\-ch\-sign\fR
مراجعه کنید)\&.
.RE
.PP
%m
.RS 4
مشابه
%M
است، اما تا
\fInc\fR
رقم با معنی گرد می‌شود (به گزینه
\fB\-\-ch\-sign\fR
مراجعه کنید)\&.
.RE
.sp
یک مقدار استاندارد برای این گزینه
"\e"%s/%m\e""
است\&. همچنین می‌توانید از آزمون‌های شرطی (با نحو پرل
( TEST ? IF\-YES : IF\-NO ))
استفاده کنید تا در صورتی که نمره برابر با حداکثر نمره باشد عبارت
\fIValid\fR
و در غیر این صورت عبارت
\fIFailed\fR
نوشته شود، با استفاده از:
.sp
.if n \{\
.RS 4
.\}
.nf
\-\-verdict\-question "(%S==%M ? \e"Valid\e" : \e"Failed\e")"
.fi
.if n \{\
.RE
.\}
.RE
.PP
\-\-verdict\-question\-cancelled \fIperl\-expression\fR
.RS 4
مشابه
\fB\-\-verdict\-question\fR
است، اما برای سوالات باطل‌شده اعمال می‌شود (به راهبرد نمره‌دهی
allowempty
مراجعه کنید)\&. مقدار پیش‌فرض
"X"
است\&.
.RE
.PP
\fB\-\-indicatives\fR
.RS 4
از این گزینه برای درخواست یادداشت‌نویسی کادرها برای سوالات توصیفی/غیرنمره‌ای استفاده کنید (نمرات این سوالات در محاسبه نمره کل لحاظ نخواهد شد\&. وضعیت درست/نادرست اغلب برای این سوالات اهمیتی ندارد، بنابراین نیازی به تصحیح کادرهای مربوطه نیست)\&.
.RE
.PP
\fB\-\-line\-width \fR\fB\fIwidth\fR\fR
.RS 4
ضخامت خط (بر حسب پوینت) را هنگام رسم نمادها برای تصحیح پاسخ‌ها تعیین می‌کند\&.
.RE
.PP
\fB\-\-symbols \fR\fB\fIsymbols\-definition\fR\fR
.RS 4
نحوه یادداشت‌نویسی کادرها را مشخص می‌کند\&. عبارت symbols\-definition فهرستی از ساختارهای جداشده با ویرگول به صورت
\fIH\fR\-\fIA\fR:\fIshape\fR:\fIcolor\fR
است، که در آن
\fIH\fR
برابر با
0
یا
1
است، بسته به این که آیا کادر باید علامت زده می‌شد یا خیر،
\fIA\fR
برابر با
0
یا
1
است، بسته به این که آیا کادر در عمل علامت زده شده است یا خیر،
\fIshape\fR
یکی از مقادیر
none،
circle،
mark،
box
است و
\fIcolor\fR
یک رنگ است (نام رنگ یا #RGB؛ برای جزئیات به مستندات ImageMagick یا GraphicsMagick مراجعه کنید)\&.
.sp
مقدار پیش‌فرض "0\-0:none,0\-1:circle:red,1\-0:mark:red,1\-1:mark:blue" است\&.
.RE
.SS "طول‌ها و فواصل (Lengths)"
.PP
طول‌های زیر می‌توانند همراه با یک واحد اندازه‌گیری (in،
ft،
pt،
cm
یا
mm)
داده شوند\&.
.PP
\fB\-\-dist\-to\-box \fR\fB\fId\fR\fR
.RS 4
فاصله از کادرها (به سمت چپ) را برای نوشتن نمرات سوالات در هنگام استفاده از
\fB\-\-position case\fR
تعیین می‌کند\&. مقدار پیش‌فرض
1cm
است\&.
.RE
.PP
\fB\-\-dist\-margin \fR\fB\fId\fR\fR
.RS 4
اندازه حاشیه را تعیین می‌کند\&. مقدار پیش‌فرض
5mm
است\&.
.RE
.PP
\fB\-\-dist\-margin\-global \fR\fB\fId\fR\fR
.RS 4
اندازه حاشیه را برای سربرگ تعیین می‌کند\&. مقدار پیش‌فرض
3mm
است\&.
.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