Help:Quiz
This is the help page for the quiz extension.
For a simple and colourful guide, see Help:Quiz-Simple.
The quiz extension consists of very simple markup. This page is long because of the many possibilities which the quiz extension opens up.
Also see the Quiz learning project.
OverviewEdit
VersionEdit
- Version 1.0 of the quiz extension is now (20 May 2007) active on Wikiversity.
- This documentation covers all the major features and most of the minor ones.
- A few exotic features are not yet covered, such as shuffle control using {X} {!X} {/X} tags.
Pedagogical considerationsEdit
- Where are the strengths and weaknesses of Wikiversity quizzing?
- How can you best use the quiz extension as a teaching tool?
- Wikiversity compared to Moodle - offers a detailed consideration of the quiz feature differences between Moodle and Wikiversity, including suggestions as to how each is best used.
How to create a quizEdit
The quiz tagEdit
wikitext (what you write) |
rendering (what you see) |
comments | |
---|---|---|---|
<quiz> insert questions here </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.Shuffle button is not shown if there is one or less questions in a quiz. | |
<quiz display=simple> insert questions here </quiz> |
|
| |
<quiz shuffle=none> insert questions here </quiz> |
|
| |
<quiz shuffleanswers=true> questions with proposal shuffled on reload here </quiz> |
|
Shuffling answers: The quiz also provides the option of automatic shuffling of answers on load.This can be achieved by using shuffleanswers parameter.When shuffleanswers parameter is set to true the answers are shuffled for each reload of the page. 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 to the way it was before submission. |
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 beginning of the lines 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
- Note: For multiple choice questions(MCQs) with negative(-) sign and positive(+) sign, the positive sign(+) signifies the correct answer while the negative(-) sign(s) signifies the wrong answer and this is how Quiz know which answer is correct and which one is wrong.
Multiple choice / single responseEdit
wikitext | rendering | comments | |
---|---|---|---|
{Question |type="()"} + The correct answer. - Distractor. - Distractor. - Distractor. |
|
|
True/false questionsEdit
wikitext | rendering | comments | |
---|---|---|---|
{Bulgaria and Romania joined the European Union in 2007. |type="()"} + TRUE. - FALSE. {Switzerland is a member of the European Union. |type="()"} - TRUE. + FALSE. {Anyone can be a Citizen Journalist. |type="()"} + TRUE. - FALSE. |
|
|
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="{}"} #free: { gratis _6 } #well: { good _4 } |
|
| |
{ |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*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]] + [[Image:Peanuts.jpg|100px]] + [[Image:Malus-Idared on tree.jpg|100px]] - [[Image:Pistachios in a bag.jpg|100px]] - [[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. You just use normal wiki-markup to insert the image(s). |
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> 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 toc.
- 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> |
|
|
Shuffle Control TagsEdit
wikitext | rendered | comments | |
---|---|---|---|
<quiz> {X} { Sample Question 2 {!X} { Sample Question 4 </quiz> |
|
Conditional shuffling using tags:It can be achieved by using {X},{!X} and {/X} tags inside quiz.Any questions that are within {X} and {/X} are treated as a block and will be shuffled.The questions that are within {!X} and {/X} are not shuffled internally, i.e the order of questions inside {!X} and {/X} remain the same.
In the example Sample Question 1 and 2 can be shuffled but Sample Question 3 and 4 are always in the same order. |
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.
Future stuffEdit
Information about future developments is mainly available at the project space on MediaWiki. Lots of things are in planning.
See alsoEdit
WikiversityEdit
WikipediaEdit
MediaWikiEdit
- The quiz extension project at MediaWiki where discussion and development of the quiz extension takes place.