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

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

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 باشد، صفحات از برگه سوالات گرفته شده و بر اساس پاسخ‌های دانش‌آموز (مشابه با برگه پاسخ‌نامه) پر یا خالی می‌شوند و همان علامت‌های تصحیح که روی برگه پاسخ‌نامه کشیده می‌شوند، رسم خواهند شد. هنگامی که حالت برابر با 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 (یا در صورت عدم وجود ستون 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 تصحیح‌شده تعیین می‌کند. در این الگو، برخی عبارت‌ها جایگزین خواهند شد:

(ID)

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

(N)

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

(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 تصحیح‌شده تعبیه (Embed) می‌شوند. گزینه‌های زیر کیفیت اسکن‌های تعبیه‌شده را به منظور کاهش حجم فایل نهایی کنترل می‌کنند.

--embedded-max-size maxsize

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

--embedded-format format

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

--embedded-jpeg-quality quality

کیفیت JPEG (از 1 تا 100) را برای اسکن‌های تعبیه‌شده با فرمت 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 )) استفاده کنید تا در صورتی که نمره برابر با حداکثر نمره باشد عبارت Valid و در غیر این صورت عبارت Failed نوشته شود، با استفاده از:

--verdict-question "(%S==%M ? \"Valid\" : \"Failed\")"

--verdict-question-cancelled perl-expression

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

--indicatives

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

--line-width width

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

--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 است.

Alexis Bienvenüe <paamc@passoire.fr>

نویسنده اصلی

Anirvan Sarkar

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

Hiroto Kagotani

ویراستار

Frédéric Bréal

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

Jean Bérard

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

Georges Khaznadar

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

کپی‌رایت © 2008-2025 Alexis Bienvenüe

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

2025-04-17 Auto Multiple Choice 1.7.0