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 usageEdit
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 GuideEdit
Thanks to the contribution of users from Wikiversity, a complex tutorial, on building your quizzes, is provided below.
The quiz tagEdit
This is how to insert a quiz into your Wikibook.
wikitext (what you write) |
rendering (what you see) |
comments | |
---|---|---|---|
<quiz> |
|
The quiz tags do the following:
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. | |
<quiz display=simple> |
|
| |
<quiz shuffle=none> |
|
|
Inserting questionsEdit
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 examplesEdit
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 pastingEdit
The markup has been slightly simplified in order to help understanding. If you copy and paste, you must insert <quiz> 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 demosEdit
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.
Basic question typesEdit
Multiple choice / single responseEdit
wikitext | rendering | comments | |
---|---|---|---|
{Question
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
- Distractor.
|
|
|
True/false questionsEdit
wikitext | rendering | comments | |||||||
---|---|---|---|---|---|---|---|---|---|
{Bulgaria and Rumania joined the
European Union in 2007.
|type="()"}
+ TRUE.
- FALSE.
{Switzerland is a member of the
European Union.
|type="()"}
- TRUE.
+ FALSE.
|
1 Bulgaria and Rumania joined the European Union in 2007.
2 Switzerland is a member of the European Union.
| ||||||||
- In many quiz systems, true/false questions are listed as a separate kind of question, although they are really nothing more than a variety of multiple choice with a single response. The Quiz Extension correctly treats true/false questions as multiple choice with a single response. They are implemented in exactly the same way as above.
- The first of the two examples shows a true/false question where the correct answer is "true".
- The second of the two examples shows a true/false question where the correct answer is "false".
- The examples are live and can be tried out now.
- If you have a large number of true/false questions, a more efficient way to lay them out would be to use the tabular response type with radio buttons documented below.
Multiple choice / multiple responseEdit
wikitext | rendering | comments | |
---|---|---|---|
{Question
|type="[]"}
+ Correct answer.
- Incorrect answer.
+ Correct answer.
- Incorrect answer.
|
|
|
Typed response (short answer)Edit
wikitext | rendering | comments | |
---|---|---|---|
{
|type="{}"}
Where was Aristotle born?
{ Stageira }
{
|type="{}"}
Name Aristotle's famous mentor.
{ Plato }
{
|type="{}"}
{ Alexander } was Aristotle's most
famous pupil.
|
|
| |
{
|type="{}"}
Name a famous Greek philosopher.
{ Aristotle|Plato }
|
|
| |
{
|type="{}"}
Name Aristotle's famous mentor.
{ Plato _6 }
|
|
| |
{ Complete each box with a synonym
of the following words
|type="{}"}
<ol>
<li>free: { gratis _6 }</li>
<li>well: { good _4 }</li>
</ol>
|
|
| |
{
|type="{}"}
Where did Aristotle die?
{ Chalcis (i) }
|
|
|
Gapfill / clozeEdit
wikitext |
{Complete the text from the Wikipedia article on [[w:Aristotle|Aristotle]].
|type="{}"}
Aristotle was born in { Stageira _8 } in Chalcidice. His parents were { Phaestis _8 }
and { Nicomachus _10 }, who became physician to King Amyntas of Macedon. Aristotle
was educated as a member of the aristocracy. At about the age of { eighteen|18 _8},
he went to { Athens _6 } to continue his education at { Plato _5 }'s Academy.
Aristotle remained at the Academy for nearly twenty years, not leaving until after
Plato's death in { 347 _3 } BC.
| |
---|---|---|
rendering |
| |
comments |
|
Numerical responseEdit
wikitext | rendering | comments | |
---|---|---|---|
{In which year was Plato born?
|type="{}"}
He was born in { 427-428 _5 } BC.
|
|
| |
{How far is the earth from the sun?
|type="{}"}
{ 91-95 _3 } million miles.
|
|
| |
{What is 10 times 10?
|type="{}"}
{ 100 5% _3 }
|
|
| |
|
|
Tabular response type with radio buttonsEdit
wikitext | rendering | comments | |
---|---|---|---|
{Question
|type="()"}
| A | B | C
+-- A is correct.
-+- B is correct.
--+ C is correct.
|
|
|
Tabular response type with checkboxesEdit
wikitext | rendering | comments | |
---|---|---|---|
{Question
|type="[]"}
| Option A | Option B | Option C
++- Question 1
(Clue: A and B are correct).
-++ Question 2 (
Clue: B and C are correct).
--+ Question 3
(Clue: C is correct).
|
|
|
Advanced stuffEdit
Inserting feedbackEdit
wikitext | rendering | comments | |
---|---|---|---|
{Question
|type="()"}
+ The correct answer.
|| Feedback for correct answer.
- Distractor.
|| Feedback for distractor.
- Distractor.
|| Feedback for distractor.
- Distractor.
|| Feedback for distractor.
|
|
|
Inserting blocks of text between questionsEdit
wikitext | rendering | comments | |
---|---|---|---|
{This is the first question.
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
{This is a block of text.}
{This is the second question.
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
|
|
|
Using images as answersEdit
wikitext | rendered | comments | |
---|---|---|---|
<quiz display=simple>
{ Which of these are not nuts? }
- [[Image:Walnut03.jpg|100px]]
||do not meet the botanical definition but walnuts are nuts in the culinary sense
+ [[Image:Peanuts.jpg|100px]]
+ [[Image:Malus-Idared on tree.jpg|100px]]
- [[Image:Pistachios in a bag.jpg|100px]]
||do not meet the botanical definition but are nuts in the culinary sense
- [[Image:Chestnut.jpg|100px]]
+ [[Image:P10802511.JPG|100px]]
</quiz>
|
|
|
Using images in the questionEdit
wikitext | rendered | comments | |
---|---|---|---|
<quiz display=simple>
{ What is this? [[Image:Butterfly tongue.jpg|100px]]
| type="()" }
- Tiger
+ Butterfly
- Bee
- Fly
</quiz>
|
|
In this example, the image is part of the question. |
Using animationsEdit
The section adds no new technical tricks, but it looks pretty.
|
|
|
Hyperlinks and other markupEdit
Markup that works inside quizzesEdit
- Hyperlinks:
[[....]]
. - Images:
[[Image:....]]
. - Other media:
[[....]]
. - Bold and italic.
<big>...</big>
and<br />
Markup that partly works inside quizzesEdit
- 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 effectsEdit
This is similar to insertion of images. Standard wiki markup is used.
Configuring pointsEdit
wikitext (what you write) |
rendering (what you see) |
comments | |
---|---|---|---|
<quiz points="3/1!">
{Try this question now.}
+ Plus 3 points for this one.
- Minus 1 point for this one.
</quiz>
|
|
| |
<quiz display=simple>
{Try this question now.
|type="()" }
+ 1 points for this one.
- 0 points for this one.
{Try this question now.
|type="()" coef="2"}
+ 2 points for this one.
- 0 points for this one.
{Try this question now.
|type="()" coef="4"}
+ 4 points for this one.
- 0 points for this one.
{Try this question now.
|type="()" coef="0.5"}
+ 1/2 point for this one.
- 0 points for this one.
</quiz>
|
|
|
TroubleshootingEdit
- 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.