diff --git a/TeachingHowTos/EmbedQuizQuestions.ipynb b/TeachingHowTos/EmbedQuizQuestions.ipynb index 93fc4a6..319acb1 100644 --- a/TeachingHowTos/EmbedQuizQuestions.ipynb +++ b/TeachingHowTos/EmbedQuizQuestions.ipynb @@ -1,210 +1,188 @@ { "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# How to add auto-corrected quiz questions to my notebooks?\n", "\n", "\n", "
There are other ways to integrate quiz questions into notebooks but the solution we suggest here has a very important characteristic: the data collected on students' responses is stored on the EPFL moodle server.
\n",
"This is extremely important in order to be consistent with the data protection and professional confidentiality provisions of Swiss law.
Add a hidden section to your moodle page
\n", "\n", "We suggest that you create an additional section (\"topic\") in your moodle course page, which will serve as a container for your quiz questions. \n", "To add a section, then go at the bottom of the moodle page and click on \"Add topics\".\n", "\n", "We also suggest that you hide this section from your moodle page so that the quiz question are visible only in the notebooks - of course, if you want your students to see the questions in your moodle page then skip this step. \n", "At the top of the section, select \"Edit\" then \"Hide topic\". A blue tage should appear just below the title of the section saying `Hidden from students`.\n", "\n", "\n", "Create a question
\n", "To create a new quiz question, use the \"Add an activity\" dropdown menu and then choose \"Interactive content\" as shown on the figure below. \n", "Attention: do not select the \"quiz\" option in the dropdown menu (this type of quiz cannot be embedded in a notebook).\n", "\n", "\n", "\n", "Select the type of question that you want in the list and click on it.\n", "\n", "\n", "\n", "Fill out the form to create your question, then choose \"Save and return to course\".\n", "\n", "Make the question available
\n", "\n", "You have to make the quiz question available outside of moodle (i.e. in your notebooks). On the right side of the activity, select the \"Edit\" menu and then click on \"Make available\", as shown on the image below.\n", "\n", "\n", "\n", "Once this is done, a blue tag saying `Available but not shown on course page` should appear right below your quiz question.\n", "\n", " " ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Step 2: embed the question into a notebook\n", "\n", "Get the URL of your question
\n", "\n", "From your moodle page, click on your new question. This will open your question and show you how it will look like for students. \n", "Click on the \"<> Embed\" link at the bottom of the question, as shown on the figure below. Copy the code which appears in the \"Embed\" popup.\n", "\n", "\n", "\n", "Paste the code into your favorite text editor and find the URL of the question, which should appear between quotes after `src=` (just after the `iframe` tag), as shown below. Copy this URL.\n", "\n", "\n", "\n", "\n", "Add your quiz question to your notebook
\n", "\n", "In your notebook, add a Python cell where you want the question to appear. Copy paste the following code snipped, which creates an iFrame in which your question will be embedded, and replace `URLOFYOURQUESTION` by the URL of your question.\n", "\n", "```python\n", "from IPython.display import IFrame\n", "IFrame('URLOFYOURQUESTION', 800, 600)\n", "```\n", "\n", "You can customize the size of the iFrame by changing the `800` (width) and `600` (height) values. \n", "\n", "You might also want to add a short line of text just before the cell to indicate to students that they have to execute the cell to see the quiz. \n", "The first time students use your notebooks, you need to explain that they also have to be logged on moodle to see the quiz - after one use, they will easily get the trick. \n", "\n", "Have a look at the demo below!" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "# Demo\n", "\n", "To be able to see the demo quiz question, you need to be registered as participant on our moodle course (this is one important limitation of this solution, please see the [Limitations section](#Limitations)). \n", "Please open a new tab or window, **log on [moodle](https://moodle.epfl.ch/enrol/index.php?id=15917)** and **register yourself on the [Noto Community moodle page](https://moodle.epfl.ch/enrol/index.php?id=15917)**.\n", "\n", "Then execute the cell below to activate the interactive quiz. \n", "\n", "" ] }, { "cell_type": "code", - "execution_count": 21, + "execution_count": null, "metadata": {}, - "outputs": [ - { - "data": { - "text/html": [ - "\n", - " \n", - " " - ], - "text/plain": [ - "