Commit e6afdf79 authored by Pascal Sotin's avatar Pascal Sotin
Browse files

documentation quiz

parent 4cdcdabf
......@@ -116,13 +116,13 @@ Par exemple :
.. code:: rst
.. important:: Pourquoi il ne faut pas habiller les animaux ?
.. important:: Pourquoi il ne faut pas habiller les animaux
:wrap: maybe
- Parce que le cochon salirait ses vêtements
- Parce que la chèvre les mangerait
.. important:: Pourquoi il ne faut pas habiller les animaux ?
.. important:: Pourquoi il ne faut pas habiller les animaux
:wrap: maybe
- Parce que le cochon salirait ses vêtements
......@@ -148,3 +148,132 @@ Code couleur :
| | | (du 1e coup / corrigé)|
+----------------+-----------------+-----------------------+
À terme, les quiz seront de trois formes :
- Choix multiple et réponse unique (boutons radio)
- Réponse libre (champ texte)
- Choix multiple et réponses multiples *(checkboxes)*
Question à choix multiple et réponse unique
*******************************************
Exemple :
.. code:: rst
.. quiz:: Quelle est la capitale du Kenya ?
.. answer:: Nairobi
:correct:
.. answer:: Addis-Abeba
:wrong: C'est la capitale de l'Éthiopie
.. anwser:: Mogadiscio
:wrong: C'est la capitale de la Somalie
Le tag :code:`:correct:` indique la réponse correcte.
Le tag :code:`:wrong` indique une réponse incorrecte.
Ces deux tags sont éventuellement suivis d'un feedback.
On attend au moins deux réponses, dont une et une seule correcte.
Les réponses seront affichées dans un ordre aléatoire ; toujours le même pour un même jeu de réponses.
Affichage du feedback
+++++++++++++++++++++
- En cas de réponse erronée, le feedback *de cette réponse* est affichée, précédé de « Non. » ; en l'absence de feedback, l'affichage est « Non ! ».
- En cas de réponse correcte, *tous* les feedbacks sont affichés, rattachés chacun à leur réponse. Le feedback de la réponse correcte sera précédé de « Oui. » ; en l'absence de ce feedback, l'affichage sera « Oui ! ».
Vérification du texte
+++++++++++++++++++++
Le tag :code:`:pattern:` précise un motif pour vérifier la réponse.
- Si ce motif commence par :code:`/`, on utilise le pattern tel quel en JavaScript.
- Si ce motif ne commence par par :code:`/`, on utilise le pattern :code:`/<motif>/i`
- En l'absence du tag pattern on utilise le pattern :code:`/<réponse_déspécialisée>/i`
Question à réponse libre
************************
Exemple :
.. code:: rst
.. quiz:: Donner le nom de la méthode qui permet de selectionner un fragment de chaîne de caractère.
.. answer:: substring
Si le quiz a une unique réponse, ce quiz est réputé à réponse libre et cette réponse est réputée correcte.
Autre exemple :
.. code:: rst
.. quiz:: Quelle entreprise a lancé le langage Java ?
:open:
.. answer:: Sun
:correct:
:pattern: Sun (Microsystems?)?
.. answer:: Oracle
:wrong: Oracle n'a fait que racheter Java, mais à qui ?
Le tag :code:`:open:` signale une question à réponse libre.
Affichage du feedback
+++++++++++++++++++++
Le feedback d'une question à réponse libre est rattaché au champs texte.
- Si la réponse saisie correspond à la bonne réponse, on affiche « Oui. » suivi du feedback spécifique ou simplement « Oui ! ».
- Si la réponse saisie correspond à une mauvaise réponse, on affiche « Non. » suivi du feedback spécifique ou bien « Non. Ce n'est pas XXX ».
- Si la réponse saisie ne correspond à aucune réponse, on affiche « Non... ».
Question à choix multiple et réponses multiples
***********************************************
Exemple :
.. code:: rst
.. quiz:: Sélectionnez les fruits.
.. answer:: Tomate
:correct: Hé oui. La tomate est un fruit.
.. answer:: Coing
:correct:
.. answer:: Radis
:wrong:
.. answer:: Gland
:correct:
Si un quiz a plusieurs bonnes réponses, il est réputé à réponse multiples.
Les réponses seront affichées dans un ordre aléatoire ; toujours le même pour un même jeu de réponses.
Autre exemple :
.. code:: rst
.. quiz:: Selectionnez les enseignants du module Algo avancée
:multiple:
.. answer:: AP
:correct: Pour André Péninou.
.. anwser:: POS
:wrong:
.. answer:: PGR
:wrong:
Sécurité
********
Ni l'examen rapide du code source, ni l'inspection de la page Web ne doivent permettre de déterminer quelles sont les bonnes et les mauvaises réponses.
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment