AUTO-MULTIPLE-CHOI(1) Auto Multiple Choice AUTO-MULTIPLE-CHOI(1)

auto-multiple-choice-annotate.ja - حاشیه‌نویسی و تصحیح برگه‌های پاسخ‌نامه آزمون‌های چندگزینه‌ای

auto-multiple-choice annotate --project project-dir --names-file students.csv [annotation options...]

دستور auto-multiple-choice annotate نمرات تک‌تک سوالات و نمره کل را در پاسخ‌نامه‌های آزمون درج کرده و فایل‌های PDF خروجی (یک فایل مجزا برای هر داوطلب یا یک فایل واحد برای کل داوطلبان) تولید می‌کند.

--project project-dir

نام یا دایرکتوری پروژه را تعیین می‌کند.

--data project-data-dir

دایرکتوری حاوی فایل‌های داده را مشخص می‌کند (مقدار پیش‌فرض project-dir/data است).

--pdf-dir pdf-dir

دایرکتوری PDF پروژه را برای خروجی پاسخ‌نامه‌های تصحیح‌شده تعیین می‌کند (مقدار پیش‌فرض project-dir/cr/corrections/pdf است).

--names-file students-list.csv

نام فایل فهرست داوطلبان را تعیین می‌کند.

--names-encoding encoding

کدگذاری فایل students-list.csv را مشخص می‌کند (مقدار پیش‌فرض utf-8 است).

--association-key key

کلید شناسایی داوطلب (نام ستون در فایل فهرست داوطلبان) را مشخص می‌کند. مقدار پیش‌فرض بر اساس مقداری که در عمل برای شناسایی و انتساب استفاده شده در پایگاه داده ذخیره می‌شود، بنابراین نیازی به استفاده از این گزینه نیست.

--subject subject.pdf

مسیر فایل PDF سوالات آزمون را تعیین می‌کند (مقدار پیش‌فرض project-dir/DOC-sujet.pdf است).

--compose mode

در صورتی که می‌خواهید صفحاتی از برگه سوالات را که فاقد کادر علامت‌گذاری هستند (مانند صفحات سوالات پیش از پاسخ‌نامه) اضافه کنید، از این گزینه استفاده کنید. هنگامی که mode برابر با 1 باشد، صفحات از برگه سوالات گرفته شده و بر اساس پاسخ‌های داوطلب علامت‌گذاری می‌شوند و همان علائم تصحیح پاسخ‌نامه روی آن‌ها درج می‌گردد. هنگامی که mode برابر با 2 باشد، صفحات از پاسخ‌نامه تصحیح‌شده (کلید آزمون) گرفته شده و (به دلیل تکراری بودن) علائم تصحیح روی آن‌ها درج نمی‌شود.

--corrected corrected.pdf

مسیر فایل PDF کلید تصحیح آزمون را مشخص می‌کند (مقدار پیش‌فرض project-dir/DOC-corrected.pdf است؛ اگر فایل وجود نداشته باشد، با استفاده از مقادیر گزینه‌های --n-copies، --with، --filter و --filtered-source ساخته می‌شود).

--darkness-threshold t

حد آستانه نسبت پیکسل‌های سیاه را تعیین می‌کند. مقدار پیش‌فرض بر اساس مقداری که در عمل برای نمره‌دهی استفاده شده در پایگاه داده ذخیره می‌شود، بنابراین نیازی به استفاده از این گزینه نیست.

--darkness-threshold-up upper_t

حد بالای آستانه نسبت پیکسل‌های سیاه را تعیین می‌کند. مقدار پیش‌فرض بر اساس مقداری که در عمل برای نمره‌دهی استفاده شده در پایگاه داده ذخیره می‌شود، بنابراین نیازی به استفاده از این گزینه نیست.

--csv-build-name name-model

الگوی ساخت نام داوطلبان از روی فایل فهرست داوطلبان را تعیین می‌کند. مقدار پیش‌فرض «(nom|surname) (prenom|name)» است که در این حالت، نام با استفاده از محتوای ستون nom (یا در صورت عدم وجود، ستون surname) و به دنبال آن محتوای ستون prenom (یا در صورت عدم وجود، ستون name) ساخته می‌شود و در نتیجه برای فایل‌های CSV ساده فرانسوی یا انگلیسی مناسب خواهد بود.

--id-file ids.txt

فایل حاوی فهرست شناسه برگه‌های امتحانی مورد نظر برای تصحیح را مشخص می‌کند (یک شناسه در هر خط؛ در حالت برگه انفرادی، شماره داوطلب و در حالت برگه کپی‌شده به صورت student:copy). اگر فایلی مشخص نشود، تمامی برگه‌ها تصحیح و حاشیه‌نویسی می‌شوند.

--debug file.log

فایلی را برای ذخیره اطلاعات اشکال‌زدایی (دیباگ) مشخص می‌کند.

--single-output

در صورتی که می‌خواهید تمام برگه‌های تصحیح‌شده در قالب یک فایل PDF واحد تجمیع شوند، از این گزینه استفاده کنید. رفتار پیش‌فرض، ساخت یک فایل PDF مجزا به ازای هر داوطلب است.

--sort s

کلید مرتب‌سازی را مشخص می‌کند (تنها هنگام استفاده از --single-output معتبر است):

l

بر اساس ترتیب فایل فهرست داوطلبان.

m

بر اساس نمرات داوطلبان.

i

بر اساس شناسه برگه آزمون.

n

بر اساس نام داوطلبان.

--filename-model model

الگوی نام فایل را برای فایل‌های PDF تصحیح‌شده تعیین می‌کند. در این الگو، دنباله‌های خاص به صورت زیر جایگزین می‌شوند:

(N)

با نام داوطلب (به --csv-build-name مراجعه کنید) جایگزین می‌شود.

(ID)

با شماره داوطلب جایگزین می‌شود.

(COL)

با مقدار ستون COL در فهرست داوطلبان جایگزین می‌شود.

مقدار پیش‌فرض «(N)-(ID).pdf» است.

این گزینه‌ها زمانی استفاده می‌شوند که مسیر فایل مشخص‌شده با --corrected وجود نداشته باشد و نیاز به بازسازی آن باشد.

--src mcq-source-file --n-copies n --with latex-engine --filter filter-name --filtered-source fs.tex

به auto-multiple-choice-prepare(1) مراجعه کنید.

در صورت وجود تصاویر اسکن‌شده، در فایل PDF تصحیح‌شده تعبیه می‌شوند. گزینه‌های زیر کیفیت تصاویر اسکن تعبیه‌شده را کنترل می‌کنند تا حجم فایل خروجی کاهش یابد.

--embedded-max-size maxsize

حداکثر ابعاد تصاویر اسکن را بر حسب پیکسل (در قالب widthxheight) تعیین می‌کند. مقدار پیش‌فرض خالی است که به معنی عدم محدودیت اندازه می‌باشد. اسکن‌های بزرگ‌تر از ابعاد تعیین‌شده پیش از گنجانده شدن در فایل تصحیح‌شده کوچک می‌شوند.

--embedded-format format

فرمت گنجاندن تصاویر اسکن را به صورت jpeg یا png تعیین می‌کند.

--embedded-jpeg-quality quality

کیفیت تصویر را هنگام تعبیه به صورت JPEG (از ۱ تا ۱۰۰) مشخص می‌کند.

گزینه‌های زیر نحوه درج نمرات و نشانه‌های تصحیح را کنترل می‌کنند.

--font-size fs

اندازه قلم را بر حسب پوینت برای درج نمرات تعیین می‌کند.

--text-color color

رنگ متن نمرات را مشخص می‌کند. مقدار پیش‌فرض red (قرمز) است.

--verdict header

سربرگ متنی را برای چاپ در صفحه اول پاسخ‌نامه هر داوطلب تعیین می‌کند. این متن می‌تواند شامل نویسه بازگشت به سر خط (CR) برای سربرگ‌های چندخطی باشد. دنباله‌های مشخص زیر در آن جایگزین می‌شوند:

%S

با مجموع نمره خام داوطلب جایگزین می‌شود.

%M

با حداکثر نمره خام ممکن جایگزین می‌شود.

%s

با نمره تراز داوطلب جایگزین می‌شود.

%m

با حداکثر نمره ممکن جایگزین می‌شود.

%(ID)

با نام داوطلب جایگزین می‌شود.

%(COL)

با مقدار ستون COL در فهرست داوطلبان جایگزین می‌شود.

--position pos

محل درج نمره هر سوال را تعیین می‌کند:

marge

درج نمرات در حاشیه سمت چپ

marges

درج نمرات در نزدیک‌ترین حاشیه (سمت چپ یا راست)

case

درج نمرات در نزدیکی کادرهای علامت‌گذاری

none

عدم درج نمرات

--verdict-question perl-expression

متن کنار هر سوال را از طریق یک عبارت پرل (Perl) که باید ارزیابی شود تعیین می‌کند (اگر به یک متن ساده نیاز دارید، آن را درون " قرار دهید). پیش از ارزیابی، برخی دنباله‌ها جایگزین می‌شوند:

%S

با نمره خام این سوال جایگزین می‌شود.

%M

با حداکثر نمره خام این سوال جایگزین می‌شود.

%s

مشابه %S است، اما تا nc رقم با معنی گرد می‌شود (به گزینه --ch-sign مراجعه کنید).

%m

مشابه %M است، اما تا nc رقم با معنی گرد می‌شود (به گزینه --ch-sign مراجعه کنید).

مقدار پیش‌فرض این گزینه «"%s/%m"» است. همچنین می‌توانید از عبارات شرطی (با نحو پرل به صورت ( TEST ? IF-YES : IF-NO )) استفاده کنید. برای نوشتن قبول در صورت کسب نمره کامل و در غیر این صورت مردود، می‌توانید مانند زیر عمل کنید:

--verdict-question "(%S==%M ? \"قبول\" : \"مردود\")"

--verdict-question-cancelled perl-expression

مشابه --verdict-question است، اما برای سوالات لغوشده اعمال می‌شود (به راهبرد نمره‌دهی allowempty مراجعه کنید). مقدار پیش‌فرض "X" است.

--indicatives

از این گزینه برای درخواست درج نمرات در سوالات غیرنمره‌ای/راهنما استفاده کنید (نمرات این سوالات در محاسبه نمره کل لحاظ نخواهد شد. وضعیت درست/نادرست معمولاً برای این سوالات اهمیتی ندارد، بنابراین نیازی به علامت‌گذاری کادرهای مربوطه نیست).

--line-width width

عرض خط (بر حسب پوینت) را هنگام رسم نمادها برای تصحیح پاسخ‌ها تعیین می‌کند. مقدار پیش‌فرض 2 است.

--symbols symbols-definition

نحوه علامت‌گذاری کادرها را مشخص می‌کند. symbols-definition فهرستی از ساختارهای جداشده با ویرگول به صورت H-A:shape:color است که در آن H برابر با 0 یا 1 بوده و مشخص می‌کند که آیا کادر باید علامت زده می‌شد یا خیر، A برابر با 0 یا 1 بوده و مشخص می‌کند که آیا کادر در عمل علامت زده شده است یا خیر، shape یکی از موارد none، circle، mark، box است و color یک رنگ است (نام رنگ یا #RGB، برای جزئیات به مستندات ImageMagick یا GraphicsMagick مراجعه کنید).

مقدار پیش‌فرض «0-0:none,0-1:circle:red,1-0:mark:red,1-1:mark:blue» است.

طول‌های زیر می‌توانند همراه با یک واحد اندازه‌گیری (in، ft، pt، cm یا mm) مشخص شوند.

--dist-to-box d

فاصله از کادرها (به سمت چپ) را برای نوشتن نمرات سوالات در هنگام استفاده از --position case تعیین می‌کند. مقدار پیش‌فرض 1cm است.

--dist-margin d

اندازه حاشیه را تعیین می‌کند. مقدار پیش‌فرض 5mm است.

--dist-margin-global d

اندازه حاشیه سربرگ را تعیین می‌کند. مقدار پیش‌فرض 3mm است.

Bienvenue Alexis[FAMILY Given] <paamc@passoire.fr>

نویسنده اصلی

Sarkar Anirvan[FAMILY Given]

نویسنده و ویراستار

Kagotani Hiroto[FAMILY Given]

ویراستار

Brédéric Bréal[FAMILY Given]

نویسنده و ویراستار

Bérard Jean[FAMILY Given]

ترجمه از فرانسوی به انگلیسی

Khaznadar Georges[FAMILY Given]

ترجمه از فرانسوی به انگلیسی

Kagotani Hiroto[FAMILY Given]

ترجمه از انگلیسی به ژاپنی

حق نشر © 2008-2018 Alexis Bienvenüe

این سند بر اساس شرایط مجوز عمومی همگانی گنو (GNU GPL) نسخه ۲ یا بالاتر قابل استفاده است.

2025-04-17 Auto Multiple Choice 1.7.0