.\" Man page generated from reStructuredText.
.
.TH WEBQUIZ: A LATEX PACKAGE FOR WRITING ONLINE QUIZZES  "" "" ""
.SH "نام (NAME)"
webquiz \- یک بسته LaTeX برای نگارش آزمون‌های آنلاین
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.sp
\fI\%WebQuiz\fP امکان استفاده از \fI\%LaTeX\fP را برای نگارش آزمون‌های تعاملی آنلاین فراهم می‌کند.
آزمون‌ها ابتدا در \fI\%LaTeX\fP نوشته شده و سپس با استفاده از \fI\%WebQuiz\fP که به زبان python نوشته شده است، به HTML تبدیل می‌شوند. تبدیل از \fI\%LaTeX\fP به HTML در پشت صحنه با استفاده از \fI\%TeX4ht\fP انجام می‌شود. ایده اصلی این است که بتوانید تنها با استفاده از \fI\%WebQuiz\fP و داشتن دانشی پایه‌ای از \fI\%LaTeX\fP، آزمون‌های آنلاین مناسب و زیبایی ایجاد کنید.
.sp
\fI\%WebQuiz\fP برای استفاده از طریق خط فرمان طراحی شده است. برای نمونه، اگر \fIquiz1.tex\fP یک فایل LaTeX برای یک آزمون باشد:
.INDENT 0.0
.TP
.B \fIlatex quiz1\fP
یک فایل DVI «خوانا» برای آزمون تولید می‌کند
.TP
.B \fIpdflatex quiz1\fP
یک فایل PDF «خوانا» برای آزمون تولید می‌کند
.TP
.B \fIwebquiz quiz1\fP
صفحه وب \fIquiz1.html\fP را ایجاد می‌کند
.UNINDENT
.sp
اگر ترجیح می‌دهید از یک رابط گرافیکی (GUI) برای \fI\%LaTeX\fP استفاده کنید، باید پیکربندی آن برای استفاده مستقیم از \fI\%WebQuiz\fP امکان‌پذیر باشد. به عنوان نمونه، در دفترچه راهنما جزئیاتی درباره نحوه انجام این کار در TeXShop ارائه شده است.
.SH "نحوه استفاده (USAGE)"
.INDENT 0.0
.TP
.B usage: webquiz [\-h] [\-q] [\-d] [\-s] [\-\-latex | \-l | \-x] [\-r RCFILE]
[\-i | \-e | \-\-settings [SETTINGS]]
[quiz_file [quiz_file ...]]
.UNINDENT
.sp
یک بسته LaTeX برای نگارش آزمون‌های آنلاین
.INDENT 0.0
.TP
.B آرگومان‌های مکانی:
quiz_file             فایل‌های آزمون latex
.TP
.B گزینه‌های اختیاری:
.INDENT 7.0
.TP
.B \-h\fP,\fB  \-\-help
نمایش این پیام راهنما و خروج
.TP
.B \-q\fP,\fB  \-\-quiet
فرونشاندن پیام‌های tex4ht (همچنین با \-qq و غیره)
.TP
.B \-d\fP,\fB  \-\-draft
استفاده از حالت پیش‌نویس (draft) در make4ht
.TP
.B \-s\fP,\fB  \-\-shell\-escape
فعال‌سازی shell escape برای tex4ht/make4ht
.TP
.B \-\-latex
استفاده از latex برای کامپایل سند با make4ht (پیش‌فرض)
.TP
.B \-l\fP,\fB  \-\-lua
استفاده از lualatex برای کامپایل آزمون
.TP
.B \-x\fP,\fB  \-\-xelatex
استفاده از xelatex برای کامپایل آزمون
.TP
.BI \-r \ RCFILE\fP,\fB \ \-\-rcfile \ RCFILE
تعیین مکان فایل پیکربندی (rc\-file) برای webquiz
.TP
.B \-i\fP,\fB  \-\-initialise\fP,\fB  \-\-initialize
نصب مؤلفه‌های وب webquiz
.TP
.B \-e\fP,\fB  \-\-edit\-settings
ویرایش تنظیمات پیش‌فرض webquiz
.TP
.BI \-\-settings \ <SETTINGS>
فهرست کردن تنظیمات پیش‌فرض webquiz
.UNINDENT
.UNINDENT
.SH "نصب (INSTALLATION)"
.sp
برای استفاده از \fI\%WebQuiz\fP باید یک توزیع استاندارد \fI\%LaTeX\fP (مانند \fI\%TeXLive\fP) که شامل \fI\%TeX4ht\fP باشد را روی سیستم نصب داشته باشید. علاوه بر این، به \fI\%Python3\fP نیز نیاز دارید. از آنجا که \fI\%WebQuiz\fP از تصاویر برداری مقیاس‌پذیر (SVG) استفاده می‌کند، باید بررسی کنید که تمام وابستگی‌های \fI\%dvisvgm\fP روی سیستم شما نصب شده باشند، به‌ویژه اگر قصد استفاده از نمودارها یا تصاویر را دارید.
.sp
پس از نصب مؤلفه‌های TeX از بستهٔ \fI\%WebQuiz\fP، می‌توانید مؤلفه‌های وب \fI\%WebQuiz\fP را با استفاده از دستور زیر از خط فرمان نصب کنید:
.sp
> webquiz \-\-initialise
.sp
اگر قصد دارید مؤلفه‌های وب \fI\%WebQuiz\fP را در یک دایرکتوری سیستمی نصب کنید، باید این دستور را از حساب مدیر سیستم اجرا نمایید، یعنی در یک سیستم شبه‌یونیکس از \fIsudo\fP استفاده کنید. برای جزئیات بیشتر درباره نصب و پیکربندی \fI\%WebQuiz\fP لطفاً بخش ۳.۲ از راهنمای \fI\%WebQuiz\fP را مطالعه کنید.
.sp
لطفاً برای جزئیات بیشتر درباره راه‌اندازی اولیه و نحوه استفاده از \fI\%WebQuiz\fP به راهنما مراجعه کنید.
.SH "نصب از فایل فشرده CTAN (INSTALLATION FROM THE CTAN ZIPFILE)"
.sp
هم در سیستم‌های شبه‌یونیکس (شامل macosx) و هم در سیستم‌های windows (با استفاده از TeXLive یا MiKTeX)، می‌توانید WebQuiz را با دریافت فایل zip آن از نشانی زیر نصب کنید:
.INDENT 0.0
.INDENT 3.5
\fI\%http://mirrors.ctan.org/macros/latex/contrib/webquiz.zip\fP
.UNINDENT
.UNINDENT
.sp
برای نصب بسته، این فایل را از حالت فشرده خارج کرده و با رفتن به زیردایرکتوری webquiz/scripts دستور زیر را اجرا کنید:
.sp
> webquiz \-\-tex\-install
.sp
(یا webquiz.bat \-\-text\-install در windows). این دستور فایل‌های webquiz را در مکان‌های استانداردشان درون ساختار درختی نصب TeX باز می‌کند، بنابراین باید از یک حساب مدیر سیستم یا با استفاده از sudo در سیستم‌های شبه‌یونیکس اجرا شود. به طور کلی این دستور اقدامات زیر را انجام می‌دهد:
.INDENT 0.0
.IP \(bu 2
یک پیوند نمادین (یا معادل آن) به فایل اجرایی اصلی WebQuiz، یعنی فایل webquiz.py در دایرکتوری scripts ایجاد می‌کند.
.IP \(bu 2
دایرکتوری latex را در نقطه‌ای از مسیر جستجوی TeX کپی کرده و سپس \fImktexlsr\fP را اجرا می‌کند تا LaTeX و WebQuiz بتوانند این فایل‌ها را پیدا کنند.
.IP \(bu 2
کد python را در زیردایرکتوری TeX scripts کپی می‌کند.
.IP \(bu 2
زیردایرکتوری doc برنامه WebQuiz را در زیردایرکتوری TeX doc/latex کپی می‌کند.
.UNINDENT
.sp
اگر از MiKTeX استفاده می‌کنید، ممکن است لازم باشد کنسول MiKTeX را باز کرده، به منوی Tasks بروید و پایگاه‌داده نام فایل‌های TeX را بازسازی (rebuild) کنید.
.sp
پس از قرار گرفتن فایل‌های بالا در جای خود، WebQuiz را با دنبال کردن دستورالعمل‌های نصب ذکرشده در بالا راه‌اندازی اولیه کنید.
.sp
عمدتاً برای اهداف توسعه، گزینهٔ خط فرمان مستندنشدهٔ دیگری نیز برای حذف این فایل‌ها از TEXMFMAIN وجود دارد:
.sp
> sudo webquiz/scripts/webquiz \-\-tex\-uninstall
.SH "نیازمندی‌های سیستم (SYSTEM REQUIREMENTS)"
.sp
برای کارکرد صحیح WebQuiz، برنامه‌های زیر باید روی سیستم شما نصب باشند:
.INDENT 0.0
.IP \(bu 2
یک توزیع به‌روز از \fI\%LaTeX\fP، مانند توزیعی که توسط \fI\%TeXLive\fP ارائه می‌شود. به‌ویژه، نیاز به نصب بودن \fI\%TeX4ht\fP و \fI\%make4ht\fP دارید. متأسفانه از زمان انتشار TeXLive 2018، به‌روزرسانی‌های عمده‌ای برای تعدادی از بسته‌های مورد استفادهٔ \fI\%WebQuiz\fP از جمله \fI\%TeX4ht\fP، \fI\%make4ht\fP، \fI\%tikz\fP و \fI\%pstricks\fP منتشر شده است. به همین دلیل، \fIاکیداً توصیه می‌شود پیش از استفاده از WebQuiz تمامی بسته‌ها را از ctan به‌روزرسانی کنید\fP\&.
.IP \(bu 2
\fI\%python3\fP در زمان نگارش این مستند، نسخه 3.7.2 در دسترس است.
.IP \(bu 2
\fI\%Javascript\fP
.IP \(bu 2
اگر قصد استفاده از \fI\%pstricks\fP به همراه \fI\%WebQuiz\fP را دارید، یا می‌خواهید راهنمای آنلاین WebQuiz را کامپایل کنید، باید اطمینان حاصل کنید که \fI\%ghostscript\fP و \fI\%dvisvgm\fP روی سیستم شما نصب بوده و به‌درستی پیکربندی شده‌اند. برای جزئیات بیشتر به راهنمای \fI\%WebQuiz\fP و مستندات \fI\%dvisvgm\fP مراجعه کنید.
.IP \(bu 2
یک وب‌سرور. برای مشاهده آزمون‌های آنلاین، طبیعتاً به یک وب‌سرور نیاز دارید. همان‌طور که در بخش \fBنصب\fP توضیح داده شد، لازم است با استفاده از دستور زیر مؤلفه‌های \fI\%WebQuiz\fP را بر روی وب‌سرور خود کپی کنید:
.sp
> webquiz \-\-initialise
.UNINDENT
.SH "نویسندگان (AUTHORS)"
.sp
بخش LaTeX برنامهٔ \fI\%WebQuiz\fP توسط Andrew Mathas و کدهای python، css و javascript توسط Andrew Mathas (و Don Taylor) بر پایه نمونهٔ اولیه Don Taylor در سال ۲۰۰۱ نوشته شده است. از سال ۲۰۰۴ نگهداری و توسعه این برنامه بر عهده Andrew Mathas بوده است. اگرچه ساختار برنامه از سال ۲۰۰۴ تغییرات بنیادینی داشته، اما ایده Don مبنی بر استفاده از \fI\%TeX4ht\fP و بخشی از کدهای او همچنان به طور گسترده مورد استفاده قرار می‌گیرند.
.sp
حق نشر (C) ۲۰۰۴\-۲۰۱۹
.SH "مجوز (LICENSE)"
.sp
اجازه‌نامه عمومی همگانی گنو، نسخه ۳، ۲۹ ژوئن ۲۰۰۷
.sp
این برنامه یک نرم‌افزار آزاد است: شما می‌توانید تحت شرایط اجازه‌نامه عمومی همگانی گنو
(\fI\%GPL\fP) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۳ اجازه‌نامه و چه (به انتخاب خودتان) هر نسخهٔ بعدی، آن را بازتوزیع کرده یا تغییر دهید.
.sp
این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به اجازه‌نامه عمومی همگانی گنو مراجعه کنید.
.\" Generated by docutils manpage writer.
.