Help:Quizzes

Interactive quizzes and exams are a great way for readers to test their knowledge, see what they have learned, and check their progress as they read a book.

Quiz usage
Books are intended to help people learn new things, and quizzes can be used to complement and improve the educational usefulness of a book. However, any work intended to only test a person's existing knowledge belongs at Wikiversity.

Help Guide
Thanks to the contribution of users from Wikiversity, a complex tutorial, on building your quizzes, is provided below.

The quiz tag
This is how to insert a quiz into your Wikibook.

{| class="wikitable" !width="30%"|wikitext (what you write)!!width="30%"|rendering (what you see)!!comments &lt;quiz&gt; insert questions here &lt;/quiz&gt;
 * valign=top width=200|
 * valign=top width=200|
 * valign=top|
 * valign=top|The quiz tags do the following:
 * They insert some standard quiz options at the top and a color-key for marking. The color-key only appears when the question is marked.
 * They add a "submit" button at the bottom for when the learner has finished the quiz and wants it marked.
 * Everything between the quiz tags is parsed by the quiz extension and turned into questions if possible.

Theoretically, it is possible to put quiz tags around each individual question, allowing a learner to mark each one in turn.

Shuffling questions: if the shuffle questions button is shown, the questions can be shuffled by clicking the button. This only works so long as the quiz-taker has not started to answer the questions. Once the quiz-taker starts answering, the order is locked.

&lt;quiz display=simple&gt; insert questions here &lt;/quiz&gt;
 * valign=top|
 * valign=top|
 * valign=top|


 * valign=top|
 * Importantly, the addition of "display=simple" as an attribute of the quiz tag removes the points table at the top.
 * This is useful for short quizzes, and especially for situations where you insert single questions between text blocks.

&lt;quiz shuffle=none&gt; insert questions here &lt;/quiz&gt;
 * valign=top|
 * valign=top|
 * valign=top|
 * valign=top|
 * If you'd like to keep the points table but get rid of the button for shuffling questions, use shuffle=none as shown.


 * }

Inserting questions
The types of questions available are shown below.

An important point is that each question must be separated by a blank line, otherwise they are merged together into one question.

How to use the examples
In the examples on this page, there is both wikitext and rendering. The wikitext shows you the code, which you can copy and paste into your pages, or just learn and understand. The rendering shows you what the result will look like.

Copying and pasting
The markup has been slightly simplified in order to help understanding. If you copy and paste, you must insert &lt;quiz&gt; tags before and after the markup. You may wish to use the quiz tags with the "display=simple" option as shown above.

Note that the actual example below also use tables for clarity. If a quiz is inserted into a table, this modifies the appearance of a quiz - for example, boxes appear around some elements in the quiz. If you don't use a table, these boxes disappear and your quiz will look plainer.

When pasting, ensure that all the symbols are aligned with the left of the page - i.e. if any line begins with a space, formatting errors may occur.

Live demos
All the examples below should work. Don't be afraid to try them out. Hitting the correction button is OK - it won't change or damage this page.

Using animations
The section adds no new technical tricks, but it looks pretty.

Markup that works inside quizzes

 * Hyperlinks:.
 * Images:.
 * Other media:.
 * Bold and italic.
 *  and

Markup that partly works inside quizzes

 * Templates:.
 * subst doesn't work.
 * Tables:.
 * Headings: e.g..
 * Warning: At the moment there is a problem with the table of contents feature.
 * Lists and indents: using #, * and :

Adding music and sound effects
This is similar to insertion of images. Standard wiki markup is used.

Troubleshooting

 * You cannot test out the quiz while editing a page, because the submit button is grayed out. If you wish to test your new quiz, then create a sandbox page somewhere else first (e.g. as a subpage of your user page), then test the quiz there, and finally transfer the quiz to its final location (and test it again anyway).
 * The quiz was developed for IE6, IE7, Firefox (and Opera?), but display quality on Opera may not be optimal, and there may be display differences between browsers.
 * A reminder: each question must be separated by a blank line, otherwise the questions are merged together into one question.