Wikiquiz/Help

General quiz's Tag

The quiz must be placed between <quiz> and </quiz> tags to function.

Example :

<quiz order="shuffle" limit="20" points="1/0.25!">
...
</quiz>

The arguments are :

• order="..." : Indicate the order in which the questions are displayed. The values are :
  • "shuffle" : The questions will be shuffled.
  • "normal"  : The questions will be displayed in the order they were written. This is the default value.
• limit="..." : Indicate the number of questions to display. This is optional.
• points="X(/Y(!))" : Indicate the points attributed by default to a question.
  • "X" : Attributed points if it were answered a complete question correctly. The default value is 1.
  • "Y" : Attributed points if an error was made for a question. The default value is 0.
  • "!" : Force the quiz's default points to the whole quiz's questions. This is particularly useful when questions of another quiz are included.

Inclusion's syntax

This is the most interesting functionality. It enables you to include questions of other quizzes coming from your wiki. Inclusion is not recursive, that means that inclusions inside included quizzes are ignored.

Example:

{{:a quiz}} limit="7"
{{:another quiz}}

The arguments are :

• {{:...}} : The page containing the quiz to be included.
• limit="..." : Indicate the number of questions which will be included. NB: If a limit is defined, the questions included will be mixed before being reduced to the limiting number.

The restrictions are :

• Each inclusion must begin on a new line.

Questions's syntax

Header's syntax

Example :

{ This is the question's header, parsed as wikitext :
* You can insert a list
* And even [[links]]
type="singleChoice" points="1/0.5"}
-Question's object-

{ This is a question with header and arguments on the same line. type="multipleChoice" }
-Question's object-

The question's header is parsed as wikitext. You can insert images, links...

The arguments are :

• type="..." : The question type. All the types of questions available and their particular syntax are listed in the section "Object's syntax". The way of adding a new type of questions to wikiquiz is not very difficult and is described in the section "Contributing" of WikiQuiz. The default value is "multipleChoice".
• points="X(/Y)" : Indicates the points attributed to this question. This is optional. The mechanism of the defaults points is described in the "General quiz's tag" section.
  • "X" : Attributed points if it were answered the complete question correctly.
  • "Y" : Attributed points if an error were made for this question.

The restrictions are :

• You can't use "{" at the begining of a line inside the header !
• You can't use "}" at the end of a line inside the header !

Object'syntax

Basic types

Wikiquiz has two basic types conceived to write questions with single or multiple choices most easily possible.

Example :

{ This is a multiple choice question. }
- proposal 1||Correction 1 using wikitext parser.
+ proposal 2||Correction 2 with additionnal informations [[link]].
- proposal 3||Correction 3
+ proposal 4 without correction.

{ This is a single choice question. type="singleChoice" }
- proposal 1||Correction 1 using wikitext parser.
+ proposal 2||Correction 2 with additionnal informations [[link]].
- proposal 3||Correction 3
- proposal 4 without correction.

The arguments are :

• "+/-" : This is required ! The values are :
  • + : The checkbox or the radio button must be checked.
  • - : The checkbox or the radio button musn't be checked.
• After the sign the proposal comes directly.
• ||... : The correction. This is prsed as wikitext, you can add links. This is optional.

The restrictions are :

• Each proposal must be written on a single line.

The rules are :

• Multiple choice question :
  • There can be several correct proposals.
  • To get the points, the user must select all the correct proposals.
  • The user sees himself withdrawing points if he chooses just one incorrect proposal.
• Single choice question :
  • There is only one correct proposal.
  • To get the points, the user must select the correct proposal.
  • The user sees himself withdrawing points if he chooses an incorrect proposal.
• The user do not lose points for a question which it did not answer.

Balise générale du quiz

Le quiz doit être placé entre des balises <quiz> et </quiz> pour fonctionner.

Exemple :

<quiz order="shuffle" limit="20" points="1/0.25!">
...
</quiz>

Les arguments sont :

• order="..." : Indique l'ordre dans lequel les questions sont affichées. les valeurs sont :
  • "shuffle" : Les questions seront mélangées.
  • "normal"  : Les questions seront affichées dans l'ordre où elles ont été écrites. Ceci est la valeur par défaut.
• limit="..." : Indique le nombre de questions à afficher. Ceci est optionnel.
• points="X(/Y(!))" : Indique les points attribués par défaut à une question.
  • "X" : Les points attribués si il a été répondu correctement à une question complète. La valeur par défaut est 1.
  • "Y" : Les points attribués si une erreur a été commise pour une question. La valeur par défaut est 0.
  • "!" : Force les points par défaut du quiz à l'ensemble des questions du quiz. Ceci est particulièrement utile lorsque l'on importe des questions d'un autre quiz.

Syntaxe d'inclusion

Ceci est la fonctionnalité la plus intéressante. Elle vous permet d'inclure des questions d'autres quiz provenant de votre wiki. L'inclusion n'est pas récursive, cela signifie que les inclusions à l'intérieur des quiz inclus sont ignorées.

Exemple:

{{:un quiz}} limit="7"
{{:un autre quiz}}

Les arguments sont :

• {{:...}} : La page contenant le quiz à inclure.
• limit="..." : Indique le nombre de questions qui vont être incluses. NB : Si une limite est définie, les questions icluses seront mélangées avant d'être réduite au nombre limite.

Les restrictions sont :

• Chaque inclusion doit commencer sur une nouvelle ligne.

Syntaxe des questions

Syntaxe de l'intitulé

Exemple :

{ Ceci est l'intitulé de la question, interprété en tant que wikitext :
* Vous pouvez y insérer une liste
* Et même des [[liens]]
type="singleChoice" points="1/0.5"}
-Objet de la question-

{ Ceci est une question avec l'intitulé et les arguments sur la même ligne. type="multipleChoice" }
-Objet de la question-

L'intitulé de la question est interprété comme du wikitext. Vous pouvez insérer des images, des liens...

Les arguments sont :

• type="..." : Le type de la question. Tous les types de questions disponibles et leur syntaxe particulière sont listés dans la section "Syntaxe de l'objet". La manière d'ajouter un nouveau type de questions à wikiquiz n'est pas très difficile et est décrite dans la section "Contribuer" de WikiQuiz. La valeur par défaut est "multipleChoice".
• points="X(/Y)" : Indique les points attribués à cette question. Ceci est facultatif. Le mécanisme des points par défaut est décrit dans la section "Balise générale du quiz".
  • "X" : Les points attribués si il a été répondu correctement à la question complète.
  • "Y" : Les points attribués si une erreur a été commise pour cette question.

Les restrictions sont :

• Vous ne pouvez pas utiliser "{" au début d'une ligne à l'intérieur de l'intitulé !
• Vous ne pouvez pas utiliser "}" à la fin d'une ligne à l'intérieur de l'intitulé !

Syntaxe de l'objet

Types de base

Wikiquiz possède deux types de base conçus pour écrire des questions à choix multiple ou unique le plus facilement possible.

Exemple :

{ Ceci est une question à choix multiple. }
- proposition 1||Correction 1 utilisant l'interpréteur wikitext.
+ proposition 2||Correction 2 avec des informations additionnelles en [[lien]].
- proposition 3||Correction 3
+ proposition 4 sans correction.

{ Ceci est une question à choix unique. type="singleChoice" }
- proposition 1||Correction 1 utilisant l'interpréteur wikitext.
+ proposition 2||Correction 2 avec des informations additionnelles en [[lien]].
- proposition 3||Correction 3
- proposition 4 sans correction.

Les arguments sont :

• "+/-" : Ceci est requis ! Les valeurs sont :
  • + : La case ou le bouton radio doit être sélectionné.
  • - : La case ou le bouton radio ne doit pas être sélectionné.
• Après le signe vient directement la proposition.
• ||... : La correction. Ceci est interprété comme du wikitext, vous pouvez ajouter des liens. Ceci est optionnel.

Les restrictions sont :

• Chaque proposition doit être écrite sur une seule ligne.

Les règles sont :

• Questions à choix multiple :
  • Il peut y avoir plusieurs propositions correctes.
  • Pour avoir les points, l'utilisateur doit sélectionner toutes les propositions correctes.
  • L'utilisateur se voit retirer des points si il choisit une seule proposition incorrecte.
• Question à choix unique :
  • Il y a une seule proposition correcte.
  • Pour avoir les points, l'utilisateur doit sélectionner la proposition correcte.
  • L'utilisateur se voit retirer des points si il choisit une proposition incorrecte.
• L'utilisateur ne perds pas de points pour une question à laquelle il n'a pas répondu.