summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-03-16 22:43:33 +0000
committerKarl Berry <karl@freefriends.org>2019-03-16 22:43:33 +0000
commit7e80fa208736f4ab99b1d57dd1571da41f1e3744 (patch)
tree606bd82a5737d587ef239fd58a5a58c256666178 /Master/texmf-dist/doc/man
parent9de7d0ea371387f647487812b48b51030c739bdf (diff)
webquiz
git-svn-id: svn://tug.org/texlive/trunk@50419 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man')
-rw-r--r--Master/texmf-dist/doc/man/man1/webquiz.1219
-rw-r--r--Master/texmf-dist/doc/man/man1/webquiz.man1.pdfbin0 -> 33116 bytes
2 files changed, 219 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/man/man1/webquiz.1 b/Master/texmf-dist/doc/man/man1/webquiz.1
new file mode 100644
index 00000000000..076b3c70c1b
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/webquiz.1
@@ -0,0 +1,219 @@
+.\" Man page generated from reStructuredText.
+.
+.TH WEBQUIZ: A LATEX PACKAGE FOR WRITING ONLINE QUIZZES "" "" ""
+.SH NAME
+WebQuiz: a LaTeX package for writing online quizzes \-
+.
+.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 makes it possible to use \fI\%LaTeX\fP to write interactive online quizzes.
+The quizzes are first written in \fI\%LaTeX\fP and then converted into HTML using
+\fI\%WebQuiz\fP, which is written in python. The conversion from \fI\%LaTeX\fP to HTML is
+done behind the scenes using \fI\%TeX4ht\fP\&. The idea is that you should be able to
+produce nice online quizzes using \fI\%WebQuiz\fP and basic knowledge of \fI\%LaTeX\fP\&.
+.sp
+\fI\%WebQuiz\fP is designed to be used from the command\-line. For example, if
+\fIquiz1.tex\fP is a LaTeX file for a quiz then:
+.INDENT 0.0
+.TP
+.B \fIlatex quiz1\fP
+produces a "readable" DVI file for the quiz
+.TP
+.B \fIpdflatex quiz1\fP
+produces a "readable" PDF file for the quiz
+.TP
+.B \fIwebquiz quiz1\fP
+creates the web page \fIquiz1.html\fP
+.UNINDENT
+.sp
+If you prefer to use \fI\%LaTeX\fP from a GUI for \fI\%LaTeX\fP then it should be possible to
+configure it to use \fI\%WebQuiz\fP directly. As an example, the manual provides some
+details about how to do this for 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
+A LaTeX package for writing online quizzes
+.INDENT 0.0
+.TP
+.B positional arguments:
+quiz_file latex quiz files
+.TP
+.B optional arguments:
+.INDENT 7.0
+.TP
+.B \-h\fP,\fB \-\-help
+show this help message and exit
+.TP
+.B \-q\fP,\fB \-\-quiet
+Suppress tex4ht messages (also \-qq etc)
+.TP
+.B \-d\fP,\fB \-\-draft
+Use make4ht draft mode
+.TP
+.B \-s\fP,\fB \-\-shell\-escape
+Shell escape for tex4ht/make4ht
+.TP
+.B \-\-latex
+Use latex to compile document with make4ht (default)
+.TP
+.B \-l\fP,\fB \-\-lua
+Use lualatex to compile the quiz
+.TP
+.B \-x\fP,\fB \-\-xelatex
+Use xelatex to compile the quiz
+.TP
+.BI \-r \ RCFILE\fP,\fB \ \-\-rcfile \ RCFILE
+Specify location of the webquiz rc\-file
+.TP
+.B \-i\fP,\fB \-\-initialise
+Install web components of webquiz
+.TP
+.B \-e\fP,\fB \-\-edit\-settings
+Edit default settings for webquiz
+.TP
+.BI \-\-settings \ <SETTINGS>
+List default settings for webquiz
+.UNINDENT
+.UNINDENT
+.SH INSTALLATION
+.sp
+To use \fI\%WebQuiz\fP you need to have a standard \fI\%LaTeX\fP distribution installed, such as \fI\%TeXLive\fP, that includes \fI\%TeX4ht\fP\&. In addition, you need to have \fI\%Python3\fP installed. As \fI\%WebQuiz\fP uses scalable vector graphics (SVG) you should check that all of the dependencies of \fI\%dvisvgm\fP are installed on your system, especially if you plan on using graphics or images.
+.sp
+Once the TeX components of \fI\%WebQuiz\fP package have been installed you can install the web components of \fI\%WebQuiz\fP using the following command, which needs to be run from the command line:
+.sp
+> webquiz \-\-initialise
+.sp
+If you want to install the web components of \fI\%WebQuiz\fP into a system directory then you need to run this command from an administrators account, so using \fIsudo\fP on a unix\-like system. For more details about the installation and configuration of \fI\%WebQuiz\fP please see Section 3.2 of the \fI\%WebQuiz\fP manual.
+.sp
+Please see the manual for more details about initialising and using \fI\%WebQuiz\fP\&.
+.SH INSTALLATION FROM CTAN
+.sp
+If you are installing WebQuiz using the zip file from ctan, as opposed to
+installing the package from TeX distribution like TeXLive, then the following
+steps are recommended:
+.INDENT 0.0
+.IP \(bu 2
+Create a symbolic link, or equivalent, to the main WebQuiz executable, which
+is the file webquiz.py in the scripts directory
+.IP \(bu 2
+Copy the latex directory to somewhere in TeX search path, or set your
+TEXINPUTS environment variable appropriately, and then run \fImktexlsr\fP or
+equivalent so that LaTeX and WebQuiz can find these files.
+.IP \(bu 2
+Ideally the doc subdirectory should be copied into the doc/layetx subdirecory
+of the main TeX distribution.
+.UNINDENT
+.sp
+If you are using a unix system, or macosx, there is an (undocumented)
+command\-line option \fI\-\-tex\-install\fP that installs the three different
+components of \fI\%WebQuiz\fP into the standard locations in the TeXLive
+tree:
+.INDENT 0.0
+.IP \(bu 2
+$TEXMFMAIN/tex/latex/webquiz all LaTeX files
+.IP \(bu 2
+$TEXMFMAIN/scripts/webquiz the python programs
+.IP \(bu 2
+$TEXMFMAIN/doc/latex/webquiz the documentation and web components
+.IP \(bu 2
+A symbolic link is made from the TeX bin directory to the main
+WebQuiz executable $TEXMFMAIN/scripts/webquiz/webquiz.py
+.UNINDENT
+.sp
+To install these files in TEXMFMAIN you will almost certainly need
+adminsistrator or root privledges, so on a unix\-like system you will
+need to use:
+.sp
+> sudo webquiz/scripts/webquiz \-\-tex\-install
+.sp
+In principle, this command may also work on a windows computer,
+provided that the command \fIkpsewhich\fP is available, but this is
+untested.
+.sp
+Once the files above are in place initialise WebQuiz by following the
+installation instructions above.
+.sp
+Mainly for development purposes, there is another undocumented
+command\-line option for removing these files from TEXMFMAIN:
+.sp
+> sudo webquiz/scripts/webquiz \-\-tex\-uninstall
+.SH SYSTEM REQUIREMENTS
+.sp
+In order to work WebQuiz needs the following programs to be installed on your
+system:
+.INDENT 0.0
+.IP \(bu 2
+An up\-to\-date \fI\%LaTeX\fP distribution, such as that provided by \fI\%TeXLive\fP\&. In
+particular, you need to have \fI\%TeX4ht\fP and \fI\%make4ht\fP installed.
+Unfortunately, since TeXLive 2018 was released there have been a significat
+bunber of updates to a number of packahges that \fI\%WebQuiz\fP uses, including
+updates to \fI\%TeX4ht\fP, \fI\%make4ht\fP, \fI\%tikz\fP and \fI\%pstricks\fP\&. For this reason, \fIit is
+strongly recommended that you all packages from ctan_ before using WebQuiz_\fP\&.
+.IP \(bu 2
+\fI\%python3\fP As of writing python 3.7.2 is available.
+.IP \(bu 2
+\fI\%Javascript\fP
+.IP \(bu 2
+If you plan to use \fI\%pstricks\fP with \fI\%WebQuiz\fP, or if you want to
+compile the online manual for WebQuiz, then you need to ensure that
+\fI\%ghostscript\fP and \fI\%dvisvgm\fP are installed and properly configured on your
+system. See the \fI\%WebQuiz\fP manual and the \fI\%dvisvgm\fP documentation for more
+details
+.IP \(bu 2
+A web server. To view online quizzes you of course need a web server. As
+described in the \fBInstallation\fP section you will also need to copy of the
+\fI\%WebQuiz\fP components onto your web server using the command:
+.sp
+> webquiz \-\-initialise
+.UNINDENT
+.SH AUTHORS
+.sp
+The LaTeX component of \fI\%WebQuiz\fP 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\(aqs from 2001. Since 2004 the program has been maintained and developed by Andrew Mathas. Although the program has changed substantially since 2004 Don\(aqs idea of using TeX 4ht, and some of his code, is still very much in use.
+.sp
+Copyright (C) 2004\-2019
+.SH LICENSE
+.sp
+GNU General Public License, Version 3, 29 June 2007
+.sp
+This program is free software: you can redistribute it and/or modify it
+under the terms of the GNU_General Public License
+(\fI\%GPL\fP) as published by
+the Free Software Foundation, either version 3 of the License, or (at
+your option) any later version.
+.sp
+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.
+.\" Generated by docutils manpage writer.
+.
diff --git a/Master/texmf-dist/doc/man/man1/webquiz.man1.pdf b/Master/texmf-dist/doc/man/man1/webquiz.man1.pdf
new file mode 100644
index 00000000000..b607faccad9
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/webquiz.man1.pdf
Binary files differ