Authors: Helena Rasche
Overview
Questions:
• How to make a quiz?

Objectives:
• Create a quiz

Time estimation: 15 minutes
Supporting Materials:
Published: May 19, 2022
Last modification: Oct 18, 2022
purl PURL: https://gxy.io/GTN:T00059
version Revision: 3

Interactive quizzes can be used either alone, or with a classroom of students, to check student’s knowledge.

Agenda

In this tutorial, we will cover:

## How it Works

We developed a small Kahoot-like interface, where a teacher can initiate a quiz, students can join the teacher’s session (using PeerJS), and do a collaborative quiz.

## Quiz Format

Each quiz starts a lot like the tutorials!

``````title: SQL Advanced Recap
contributors:
- hexylena
``````

Within the questions section we have a list of question

``````questions:
- title: How do you find the number of records in a query result?
- count(name)
- count(*)
- sum(id)
- max(id)
correct:
- count(name)
- count(*)
timeout: 20
type: choose-many
``````

There are a few different types of questions:

• `choose-1`, one correct answer
• `choose-many`, potentially multiple correct answers
• `poll`, there’s no right answer, just ask the students how they’re feeling!

You can include images in the main area, if you need some context for a question

``````- title: Which of these joins is NOT valid
image: /training-material/topics/data-science/images/carpentries-sql/sql-join-structure.svg
- Select * From P as P1 Join P as P2 on P1.id = P2.id
- SELECT * From P Join Q Join V on P.id = Q.person and Q.taken = V.id
- SELECT * From S join Q on S.name=V.dated and V.site = Q.quant
- SELECT * From S Join V on S.name = V.site
correct: SELECT * From S join Q on S.name=V.dated and V.site = Q.quant
timeout: 60
type: choose-1
``````

Poll’s let you check in with students, how they’re feeling, or take their opinion on what they think.

``````- title: How are you feeling?
- Great
- Horrid
timeout: 20
type: poll
live: true
``````

The `live` key there allows polls to show the results “live” and let students change answers while the time runs.

## Folder Structure

You place quizzes in a `quiz` subdirectory of your tutorial

``````.
├── quiz
│   └── a.yaml
└── tutorial.md
``````

## Inserting quizzes throughout a tutorial

If you want to show a quiz at a specific place within a tutorial

``````
{% include _includes/quiz.html id="a.yaml" %}

``````
Quiz: Test Quiz

Check your knowledge with a quiz!

• Self Study Mode - do the quiz at your own pace, to check your understanding.
• Classroom Mode - do the quiz synchronously with a classroom of students.

And then it’s available!

## Default Location

By default all quizzes are found at the bottom of the tutorial.