Creating a Quiz
By clicking the Quiz button in the top navigation, the Teacher is redirected to the Quiz list page.
Quiz list
The list show a card for each existing Quiz and a button to create a new Quiz.
Clicking on the Quiz name will open the Quiz edition page.
Clicking on Preview Quiz will open a page so that the Teacher can preview a Quiz before submitting it to Students as an Assignment.
Quiz Edition
The Quiz Edition view shows 2 fields:
- the name of the Quiz (which is mandatory)
- the content of the Quiz
Clicking on the Save button at the bottom of the screen will save the Quiz and redirect to the Quiz List view.
Writing a Quiz
The content of the Quiz is written in Markdown format.
Questions are separated by a blank line.
The question title is a level-1 Markdown title, written using a # at the start of the line.
e.g. # Who is Luke Skywalker's Jedi master ?
Single-choice Questions
Single-choice questions are written using parenthesis ( ). The correct answer should contain a x in the parenthesis (x). Incorrect answers contain a space character in the parenthesis ( ). A space character MUST separate the parenthesis and the answer label.
Single-choice questions can contain any number of answers. Only one answer can be correct.
# Who is Luke Skywalker's Jedi master ?
( ) Luke Skywalker
( ) Darth Vader
(x) Yoda
( ) Obi Wan Kenobi
Single-choice questions are rendered using radio buttons.
Multiple-choice Questions
Multiple-choice questions are written using brackets [ ]. The correct answers should contain a x in the brackets [x]. Incorrect answers contain a space character in the brackets [ ]. A space character MUST separate the brackets and the answer label.
Single-choice questions can contain any number of answers (correct or incorrect).
# Which of those ships are used by the Rebel Alliance ?
[x] X-Wing fighter
[ ] TIE Fighter
[x] Y-Wing
[x] Tantive IV
Multiple-choice questions are rendered using checkboxes.
Full-text Questions
Full-text questions are written using a equal sign >. The correct answer follows the sign. A space character MUST separate the equal sign and the answer label.
Full-text questions can only have one answer.
# How many good Star Wars movies are there ?
= 3
Full-text questions are rendered using a simple text input.
Question explanations
After each question, an explanation can be added using a Markdown blockquote syntax >.
This explanation text is rendered to the Student after the Quiz submission, and can be an explanation of the correct answer, or a link to a course material for example.
# How many good Star Wars movies are there ?
= 3
> 'A New Hope', 'The Empire Strickes Back', 'Return of the Jedi'.
Explanations can be multi-line, and must be declared directly after the question answers (no blank line separation).
Explanations can also contain HTML, such as links.
# Who is Luke Skywalker's Jedi master ?
( ) Luke Skywalker
( ) Darth Vader
(x) Yoda
( ) Obi Wan Kenobi
> Find the answer on <a href="https://en.wikipedia.org/wiki/Luke_Skywalker">Wikipedia</a>
Complete Quiz example
Below is a complete Quiz example, with 3 questions, each of one type, and explanations on each question.
# Who is Luke Skywalker's Jedi master ?
( ) Luke Skywalker
( ) Darth Vader
(x) Yoda
( ) Obi Wan Kenobi
# Which of those ships are used by the Rebel Alliance ?
[x] X-Wing fighter
[ ] TIE Fighter
[x] Y-Wing
[x] Tantive IV
# How many good Star Wars movies are there ?
= 3