WebQuiz: on-line quizzes using LaTeX

WebQuiz makes it possible to use LaTeX to write interactive web based quizzes. The quizzes are first written in LaTeX and then converted into HTML files using WebQuiz, which is written in python. The conversion from LaTeX to HTML is done behind the scenes using TeX4ht.

To use WebQuiz you need to have the following programs installed:

• LaTeX
• TeX4ht available from TeXLive, for example
• Python 3

Once the system is installed, WebQuiz is used directly from the command line. For example, if quiz1.tex is a latex file for a quiz then:

• latex quiz1 produces a "readable" dvi file for the quiz
• pdflatex quiz1 produces a "readable" pdf file for the quiz
• webquiz quiz1 creates the web page quiz1.html

Installation

WebQuiz has three different components that need to be installed:

• LaTeX files: webquiz.cls and webquiz.cfg need to be in the LaTeX search path
• python files: the main python is webquiz.py. On unix systems create a link to it using something like

      ln -s <path to webquiz directory>/webquiz.py /usr/local/bin/webquiz
  

• web files: although not strictly necessary, the files in the scripts web directory www should be put on the local web server

Once WebQuiz is available from ctan only the web files will need to be installed and this can be done using the command:

    webquiz --initialise

Distribution

To organisation of the the code in the WebQuiz repository is not suitable for distribution. To upload the package to ctan use:

    python3 setup.py ctan

Authors

The LaTeX component of WebQuiz was written by Andrew Mathas and the python, css and javascript code was written by Andrew Mathas (and Don Taylor), based on an initial protype of Don Taylor's from 2001. Since 2004 the program has been maintained and developed by Andrew Mathas. Although the program has changed substantially since 2004 some of Don's code and his idea of using TeX 4ht are still very much in use.

Copyright (C) 2013-2017

GNU General Public License, Version 3, 29 June 2007

This program is free software: you can redistribute it and/or modify it under the terms of the GNU_General Public License GPL as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.