'\" t
.\"     Title: auto-multiple-choice-annotate
.\"    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-annotate.ja \- حاشیه‌نویسی و تصحیح برگه‌های پاسخ‌نامه آزمون‌های چندگزینه‌ای
.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 باشد، صفحات از برگه سوالات گرفته شده و بر اساس پاسخ‌های داوطلب علامت‌گذاری می‌شوند و همان علائم تصحیح پاسخ‌نامه روی آن‌ها درج می‌گردد\&. هنگامی که
\fImode\fR
برابر با 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
الگوی ساخت نام داوطلبان از روی فایل فهرست داوطلبان را تعیین می‌کند\&. مقدار پیش‌فرض «(nom|surname) (prenom|name)» است که در این حالت، نام با استفاده از محتوای ستون 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
(N)
.RS 4
با نام داوطلب (به
\fB\-\-csv\-build\-name\fR
مراجعه کنید) جایگزین می‌شود\&.
.RE
.PP
(ID)
.RS 4
با شماره داوطلب جایگزین می‌شود\&.
.RE
.PP
(\fICOL\fR)
.RS 4
با مقدار ستون
\fICOL\fR
در فهرست داوطلبان جایگزین می‌شود\&.
.RE
.sp
مقدار پیش‌فرض «(N)\-(ID)\&.pdf» است\&.
.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 تصحیح‌شده تعبیه می‌شوند\&. گزینه‌های زیر کیفیت تصاویر اسکن تعبیه‌شده را کنترل می‌کنند تا حجم فایل خروجی کاهش یابد\&.
.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 (از ۱ تا ۱۰۰) مشخص می‌کند\&.
.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
مقدار پیش‌فرض این گزینه «"%s/%m"» است\&. همچنین می‌توانید از عبارات شرطی (با نحو پرل به صورت ( TEST ? IF\-YES : IF\-NO )) استفاده کنید\&. برای نوشتن
\fIقبول\fR
در صورت کسب نمره کامل و در غیر این صورت
\fIمردود\fR،
می‌توانید مانند زیر عمل کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
\-\-verdict\-question "(%S==%M ? \e"قبول\e" : \e"مردود\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
عرض خط (بر حسب پوینت) را هنگام رسم نمادها برای تصحیح پاسخ‌ها تعیین می‌کند\&. مقدار پیش‌فرض 2 است\&.
.RE
.PP
\fB\-\-symbols \fR\fB\fIsymbols\-definition\fR\fR
.RS 4
نحوه علامت‌گذاری کادرها را مشخص می‌کند\&. \fIsymbols\-definition\fR فهرستی از ساختارهای جداشده با ویرگول به صورت
\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
\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