diff options
author | Karl Berry <karl@freefriends.org> | 2019-04-01 21:07:31 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2019-04-01 21:07:31 +0000 |
commit | ca790e6da556783aa072a2b1d21eee01b100ec32 (patch) | |
tree | 226da3ee026929e682fb4f71fa403a42487ae758 /Master/texmf-dist/doc/latex/webquiz/webquiz.tex | |
parent | b9279e1b4ddf93b0d93a9f62ba3335fc2386cebb (diff) |
webquiz (1apr19)
git-svn-id: svn://tug.org/texlive/trunk@50694 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/webquiz/webquiz.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/webquiz/webquiz.tex | 49 |
1 files changed, 41 insertions, 8 deletions
diff --git a/Master/texmf-dist/doc/latex/webquiz/webquiz.tex b/Master/texmf-dist/doc/latex/webquiz/webquiz.tex index f0b63b41a05..808c7f032a4 100644 --- a/Master/texmf-dist/doc/latex/webquiz/webquiz.tex +++ b/Master/texmf-dist/doc/latex/webquiz/webquiz.tex @@ -85,16 +85,16 @@ \renewcommand*\contentsname{\relax} % hyperref links to ctan -\newcommand\TeXLive{\ctan[/]{\TeX Live}\xspace} +\newcommand\TeXLive{\href{https://www.tug.org/texlive/}{\TeX Live}\xspace} \newcommand\Ctan{\ctan[]{ctan}\xspace} \newcommand\ddash{\texttt{\textemdash\textemdash}} \NewDocumentCommand\webquizrc{s}{\index{webquizrc}% \BashCode|webquizrc| file\IfBooleanF{#1}{ (\autoref{SS:rcfile})}\xspace% } - +\newcommand\MiKTeX{\href{https://miktex.org/}{MiK\TeX}\xspace} \NewDocumentCommand\OnlineManual{s}{% \href{http://www.maths.usyd.edu.au/u/mathas/WebQuiz/webquiz-online-manual.html}{Online manual}% - \IfBooleanF{#1}{ (\hyperref[S:online]{Appendix B})}\xspace% + \IfBooleanF{#1}{ (\hyperref[S:online]{Appendix~B})}\xspace% } \indexprologue{% @@ -423,7 +423,7 @@ are due to Thomas Cailleteau Michael Palmer and - Hendrik Suess, + Hendrik Suess for helpful feedback on the package. \section{The \WebQuiz document class --- \hologo{LaTeX}{} commands} @@ -1548,7 +1548,7 @@ In order to work \WebQuiz needs the following programs to be installed on your system: - \begin{itemize} + \begin{itemize}[nosep] \item An up-to-date \LaTeX{} distribution, such as that provided by \TeXLive. In particular, you need to have \TeXfht{} and \ctan{make4ht} installed. @@ -1569,6 +1569,39 @@ will need to install the web components of \WebQuiz. \end{itemize} + \subsection{Installing + \WebQuiz}\label{SS:Install}\index{install}\index{miktex@Mik\TeX}\index{texlive@\TeXLive} + \WebQuiz will be included as a package in \TeXLive 2019 and, once a + packaging issue is sorted out, it will be included in \MiKTeX. If + \WebQuiz is available as a package from either of these distributions + then it can be installed in the usual way. + + Alternatively, it is possible to download the + \href{http://mirrors.ctan.org/macros/latex/contrib/webquiz.zip}{WebQuiz zipfile} from \Ctan. + To install \WebQuiz from the zipfile you should: + \begin{enumerate}[nosep] + \item Download the + \href{http://mirrors.ctan.org/macros/latex/contrib/webquiz.zip}{WebQuiz zipfile} from \Ctan. + \item Unzip the file + \item Change directory of the \BashCode|webquiz/scripts| subdirectory from the zipfile + \item From an administrators account, or using \BashCode|sudo| on a + unix-like system, run he command: + \begin{bashcode} + > webquiz --tex-install + \end{bashcode} + On windows, use: + \begin{bashcode} + > webquiz.bat --tex-install + \end{bashcode} + \end{enumerate} + This will install the different components of \WebQuiz to their + ``standard'' locations in he \TeX\ search tree. If you are using + \MiKTeX you may need to open the \MiKTeX console, go to the Tasks menu + and then rebuild the TeX filename database. + + Once the \WebQuiz package is installed you should initialise thew + package, following the steps given in \autoref{SS:Initialise}. + \subsection{Initialising \WebQuiz}\label{SS:Initialise} \CrossIndex{command-line option}{initialise} \index{initialisation} @@ -1681,7 +1714,7 @@ \href{https://en.wikipedia.org/wiki/Scalable_Vector_Graphics}{Scalable Vector Graphics} (SVG). This is done using his is done using \ctan{dvisvgm}. At first sight this is OK because \ctan{dvisvgm} is - included in \TeXLive and Mik\TeX, however, \ctan{dvisvgm} uses + included in \TeXLive and \MiKTeX, however, \ctan{dvisvgm} uses \Ghostscript and this needs to be correctly configured and, as outlined in \href{http://dvisvgm.bplaced.net/FAQ}{FAQ}, \ctan{dvisvgm} needs to know where to find the \Ghostscript libraries. For example, @@ -1901,8 +1934,8 @@ exit (currently \webquiz{version}) \item[\ddash tex-install] Use this command-line option if - are are installing the \LaTeX{} components of - \WebQuiz from the \Ctan zip-file. It will install the different + you are installing the \LaTeX{} components of + \WebQuiz from the \Ctan zip-filei (see \autoref{SS:Install}). It will install the different \LaTeX{} components of \WebQuiz into \BashCode|TEXMFMAIN|. If you installed \WebQuiz as part of a \TeX{} distribution, such as \TeXLive, then you do not need to use this option. |