نام (NAME)

webquiz - یک بسته LaTeX برای نگارش آزمون‌های آنلاین

WebQuiz امکان استفاده از LaTeX را برای نگارش آزمون‌های تعاملی آنلاین فراهم می‌کند. آزمون‌ها ابتدا در LaTeX نوشته شده و سپس با استفاده از WebQuiz که به زبان python نوشته شده است، به HTML تبدیل می‌شوند. تبدیل از LaTeX به HTML در پشت صحنه با استفاده از TeX4ht انجام می‌شود. ایده اصلی این است که بتوانید تنها با استفاده از WebQuiz و داشتن دانشی پایه‌ای از LaTeX، آزمون‌های آنلاین مناسب و زیبایی ایجاد کنید.

WebQuiz برای استفاده از طریق خط فرمان طراحی شده است. برای نمونه، اگر quiz1.tex یک فایل LaTeX برای یک آزمون باشد:

latex quiz1: یک فایل DVI «خوانا» برای آزمون تولید می‌کند
pdflatex quiz1: یک فایل PDF «خوانا» برای آزمون تولید می‌کند
webquiz quiz1: صفحه وب quiz1.html را ایجاد می‌کند

اگر ترجیح می‌دهید از یک رابط گرافیکی (GUI) برای LaTeX استفاده کنید، باید پیکربندی آن برای استفاده مستقیم از WebQuiz امکان‌پذیر باشد. به عنوان نمونه، در دفترچه راهنما جزئیاتی درباره نحوه انجام این کار در TeXShop ارائه شده است.

نحوه استفاده (USAGE)

usage: webquiz [-h] [-q] [-d] [-s] [--latex | -l | -x] [-r RCFILE]: [-i | -e | --settings [SETTINGS]] [quiz_file [quiz_file ...]]

یک بسته LaTeX برای نگارش آزمون‌های آنلاین

آرگومان‌های مکانی:: quiz_file فایل‌های آزمون latex
گزینه‌های اختیاری:

-h, --help: نمایش این پیام راهنما و خروج
-q, --quiet: فرونشاندن پیام‌های tex4ht (همچنین با -qq و غیره)
-d, --draft: استفاده از حالت پیش‌نویس (draft) در make4ht
-s, --shell-escape: فعال‌سازی shell escape برای tex4ht/make4ht
--latex: استفاده از latex برای کامپایل سند با make4ht (پیش‌فرض)
-l, --lua: استفاده از lualatex برای کامپایل آزمون
-x, --xelatex: استفاده از xelatex برای کامپایل آزمون
-r RCFILE, --rcfile RCFILE: تعیین مکان فایل پیکربندی (rc-file) برای webquiz
-i, --initialise, --initialize: نصب مؤلفه‌های وب webquiz
-e, --edit-settings: ویرایش تنظیمات پیش‌فرض webquiz
--settings <SETTINGS>: فهرست کردن تنظیمات پیش‌فرض webquiz

نصب (INSTALLATION)

برای استفاده از WebQuiz باید یک توزیع استاندارد LaTeX (مانند TeXLive) که شامل TeX4ht باشد را روی سیستم نصب داشته باشید. علاوه بر این، به Python3 نیز نیاز دارید. از آنجا که WebQuiz از تصاویر برداری مقیاس‌پذیر (SVG) استفاده می‌کند، باید بررسی کنید که تمام وابستگی‌های dvisvgm روی سیستم شما نصب شده باشند، به‌ویژه اگر قصد استفاده از نمودارها یا تصاویر را دارید.

پس از نصب مؤلفه‌های TeX از بستهٔ WebQuiz، می‌توانید مؤلفه‌های وب WebQuiz را با استفاده از دستور زیر از خط فرمان نصب کنید:

> webquiz --initialise

اگر قصد دارید مؤلفه‌های وب WebQuiz را در یک دایرکتوری سیستمی نصب کنید، باید این دستور را از حساب مدیر سیستم اجرا نمایید، یعنی در یک سیستم شبه‌یونیکس از sudo استفاده کنید. برای جزئیات بیشتر درباره نصب و پیکربندی WebQuiz لطفاً بخش ۳.۲ از راهنمای WebQuiz را مطالعه کنید.

لطفاً برای جزئیات بیشتر درباره راه‌اندازی اولیه و نحوه استفاده از WebQuiz به راهنما مراجعه کنید.

نصب از فایل فشرده CTAN (INSTALLATION FROM THE CTAN ZIPFILE)

هم در سیستم‌های شبه‌یونیکس (شامل macosx) و هم در سیستم‌های windows (با استفاده از TeXLive یا MiKTeX)، می‌توانید WebQuiz را با دریافت فایل zip آن از نشانی زیر نصب کنید:

http://mirrors.ctan.org/macros/latex/contrib/webquiz.zip

برای نصب بسته، این فایل را از حالت فشرده خارج کرده و با رفتن به زیردایرکتوری webquiz/scripts دستور زیر را اجرا کنید:

> webquiz --tex-install

(یا webquiz.bat --text-install در windows). این دستور فایل‌های webquiz را در مکان‌های استانداردشان درون ساختار درختی نصب TeX باز می‌کند، بنابراین باید از یک حساب مدیر سیستم یا با استفاده از sudo در سیستم‌های شبه‌یونیکس اجرا شود. به طور کلی این دستور اقدامات زیر را انجام می‌دهد:

یک پیوند نمادین (یا معادل آن) به فایل اجرایی اصلی WebQuiz، یعنی فایل webquiz.py در دایرکتوری scripts ایجاد می‌کند.
دایرکتوری latex را در نقطه‌ای از مسیر جستجوی TeX کپی کرده و سپس mktexlsr را اجرا می‌کند تا LaTeX و WebQuiz بتوانند این فایل‌ها را پیدا کنند.
کد python را در زیردایرکتوری TeX scripts کپی می‌کند.
زیردایرکتوری doc برنامه WebQuiz را در زیردایرکتوری TeX doc/latex کپی می‌کند.

اگر از MiKTeX استفاده می‌کنید، ممکن است لازم باشد کنسول MiKTeX را باز کرده، به منوی Tasks بروید و پایگاه‌داده نام فایل‌های TeX را بازسازی (rebuild) کنید.

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

عمدتاً برای اهداف توسعه، گزینهٔ خط فرمان مستندنشدهٔ دیگری نیز برای حذف این فایل‌ها از TEXMFMAIN وجود دارد:

> sudo webquiz/scripts/webquiz --tex-uninstall

نیازمندی‌های سیستم (SYSTEM REQUIREMENTS)

برای کارکرد صحیح WebQuiz، برنامه‌های زیر باید روی سیستم شما نصب باشند:

یک توزیع به‌روز از LaTeX، مانند توزیعی که توسط TeXLive ارائه می‌شود. به‌ویژه، نیاز به نصب بودن TeX4ht و make4ht دارید. متأسفانه از زمان انتشار TeXLive 2018، به‌روزرسانی‌های عمده‌ای برای تعدادی از بسته‌های مورد استفادهٔ WebQuiz از جمله TeX4ht، make4ht، tikz و pstricks منتشر شده است. به همین دلیل، اکیداً توصیه می‌شود پیش از استفاده از WebQuiz تمامی بسته‌ها را از ctan به‌روزرسانی کنید.
python3 در زمان نگارش این مستند، نسخه 3.7.2 در دسترس است.
Javascript
اگر قصد استفاده از pstricks به همراه WebQuiz را دارید، یا می‌خواهید راهنمای آنلاین WebQuiz را کامپایل کنید، باید اطمینان حاصل کنید که ghostscript و dvisvgm روی سیستم شما نصب بوده و به‌درستی پیکربندی شده‌اند. برای جزئیات بیشتر به راهنمای WebQuiz و مستندات dvisvgm مراجعه کنید.
یک وب‌سرور. برای مشاهده آزمون‌های آنلاین، طبیعتاً به یک وب‌سرور نیاز دارید. همان‌طور که در بخش نصب توضیح داده شد، لازم است با استفاده از دستور زیر مؤلفه‌های WebQuiz را بر روی وب‌سرور خود کپی کنید:
> webquiz --initialise

نویسندگان (AUTHORS)

بخش LaTeX برنامهٔ WebQuiz توسط Andrew Mathas و کدهای python، css و javascript توسط Andrew Mathas (و Don Taylor) بر پایه نمونهٔ اولیه Don Taylor در سال ۲۰۰۱ نوشته شده است. از سال ۲۰۰۴ نگهداری و توسعه این برنامه بر عهده Andrew Mathas بوده است. اگرچه ساختار برنامه از سال ۲۰۰۴ تغییرات بنیادینی داشته، اما ایده Don مبنی بر استفاده از TeX4ht و بخشی از کدهای او همچنان به طور گسترده مورد استفاده قرار می‌گیرند.

حق نشر (C) ۲۰۰۴-۲۰۱۹

مجوز (LICENSE)

اجازه‌نامه عمومی همگانی گنو، نسخه ۳، ۲۹ ژوئن ۲۰۰۷

این برنامه یک نرم‌افزار آزاد است: شما می‌توانید تحت شرایط اجازه‌نامه عمومی همگانی گنو (GPL) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۳ اجازه‌نامه و چه (به انتخاب خودتان) هر نسخهٔ بعدی، آن را بازتوزیع کرده یا تغییر دهید.

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