One of the things that training design people tell us is that "it's good to checkpoint" during a training course with quiz questions. This is a little quiz formatter that lets us embed a quiz into the training in the wiki, as we develop it. Of course, you can use it for other things as well....
The sort of quizzes we need are simple; multiple choice, or questions answerable with a single string. This plugin allows us to design such simple quizzes in a TWiki topic (these are just examples; they don't work):
%QUIZ{"Why is the sea boiling hot?" type="select" choices="It isn't;Just because;42" correct="Just because"}%
Q1: Why is the sea boiling hot?
It isn't
Just because
42 %QUIZ{"Which of the following are English Counties?" type="select" choices="Peckham;Cheshire;Argyll;Wisconsin;Cornwall" correct="Cheshire;Cornwall"}%
Q2: Which of the following are English Counties?
Peckham
Cheshire
Argyll
Wisconsin
Cornwall %QUIZ{"How long is a yard?" type="string" correct="3.5 pints" jump="TWikiAccessControl"}%
string (string must be matched) or select (multiple choice)
choices
Semicolon separated list of choices for a multiple choice
correct
Semicolon separated list of correct answers
jump
units
Short string put after the data entry field for string questions
Installation Instructions
You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server where TWiki is running.
Like many other TWiki extensions, this module is shipped with a fully
automatic installer script written using the BuildContrib.
If you have TWiki 4.2 or later, you can install from the configure interface (Go to Plugins->Find More Extensions)
If you have any problems, then you can still install manually from the command-line:
Download one of the .zip or .tgz archives
Unpack the archive in the root directory of your TWiki installation.
Run the installer script ( perl <module>_installer )
Run configure and enable the module, if it is a plugin.
Repeat for any missing dependencies.
If you are still having problems, then instead of running the installer script:
Make sure that the file permissions allow the webserver user to access all files.
Check in any installed files that have existing ,v files in your existing install (take care not to lock the files when you check in)
Manually edit LocalSite.cfg to set any configuration variables.
If the plugin is installed, you will see a question here:
%QUIZ{"Is the QuizPlugin installed and working?" type="select" choices="yes;no;maybe" correct="yes"}%