Format GIFT

De MoodleDocs
Aller à :navigation, rechercher

Le format GIFT permet d'utiliser un éditeur de texte pour écrire des questions à choix multiple, vrai ou faux, à réponse courte, à mot manquant, et à réponse numérique dans un format simple pouvant être importé. Le format GIFT est aussi un fichier d'exportation disponible dans la banque de questions. Le format a été développé dans la communauté Moodle, mais d'autres logiciels peuvent être compatibles avec ce format à un degré plus ou moins important.

  • Lorsque vous créez un grand nombre de questions, GIFT peut offrir un moyen rapide de mettre beaucoup de questions en même temps dans une catégorie de questions ou dans une leçon.
  • Parfois, il est plus facile de tester les questions d'une catégorie de questions en les visualisant dans un fichier GIFT.

Instructions générales

Au moins une ligne vide doit être laissée entre chaque question.

Dans sa forme la plus simple, la question vient d'abord, suivie des réponses entre parenthèses, accompagnées d'un symbole d'égalité (=) indiquant la bonne réponse ou les bonnes réponses ou d'un tilde (~) indiquant les mauvaises réponses. Un dièse (#) permet d'insérer une rétroaction. Les questions peuvent être pondérées en plaçant des symboles de pourcentage (%..%) autour de la pondération. Les commentaires sont précédés de deux barres obliques (//) et ne sont pas importés.

Voici quelques exemples utiles de GIFT qui peuvent être importés ou utilisés comme modèles de base ou comme point de départ.

Encodage UTF-8

Tout fichier GIFT doit être correctement encodé en UTF8. Vous pouvez utiliser l'éditeur de texte Notepad de Microsoft qui vient avec Windows pour enregistrer vos fichiers en UTF-8.

Note : le format ANSI fonctionnera (seulement) dans les langues sans caractères spéciaux (comme ä, ö, ü, æ, å, ø, œ or ß). N’utilisez pas « Unicode » comme format, puisqu'il s'agit de UTF-16 et que cela ne fonctionnera pas.

Symboles

Voici certains des symboles communs en GIFT et leur utilité.

Symboles Utilité
// Texte Commentaire jusqu'à la fin de la ligne (optionnel)
::Titre:: Titre de la question (optionnel)
Texte Texte de la question (devient le titre si aucun titre n'est saisi)
[...Format...] Format du passage suivant de texte. Les options sont [html], [moodle], [plain] et [markdown]. Par défaut, le format est [moodle] pour le texte de la question; les autres parties de la question ont par défaut le même format que celui utilisé pour le texte de la question.
{ Début des réponses -- Sans réponses, le texte est une description de question
{T} ou {F} Réponses vrai ou faux; aussi {TRUE} et {FALSE}
{ ... =Bonne réponse ... } Bonne réponse pour les choix multiples ou les textes troués
{ ... ~Mauvaise réponse ... } Mauvaise réponse pour les choix multiples ou les textes troués
{ ... =Élément -> réponse ... } Réponse pour les questions d'appariement
#Rétroaction Rétroaction pour les réponses aux questions à choix multiple, à réponse numérique ou aux textes troués
{# Début des réponses numériques
Réponse:marge d'erreur Réponse numérique acceptée à l'intérieur d'une marge d'erreur
Limite inférieure..Limite supérieure marges de valeurs inférieure et supérieure acceptées dans une question à réponse numérique
=%n%réponse:marge d'erreur n pour cent accordé à une réponse numérique acceptée à l'intérieur d'une marge d'erreur
} Fin des réponses
\caractère Une barre oblique inverse permet de bloquer la signification de ~, =, #, {, }, et :
\n Ajout un saut de ligne dans le texte de la question -- les lignes vides délimitent les questions

Voici quelques brefs exemples :

// true/false
::Q1:: 1+1=2 {T}

// Choix multiple avec rétroaction spécifique pour les bonnes et les mauvaises réponses
::Q2:: Quelle couleur se trouve entre l'orange et le vert dans le spectre? 
{=jaune #Bonne réponse; bravo! ~rouge #Mauvaise réponse, c'est jaune. ~bleu #Mauvaise réponse, c'est jaune.}

// Texte troué
::Q3:: Deux plus {=deux =2} égalent quatre.

// Appariement
::Q4:: Quel animal mange quoi? {=Chat -> Nourriture pour chats =Chien -> Nourriture pour chiens}

// Question à réponse numérique avec marge
::Q5:: Nommez un chiffre de 1 à 5. {#3:2}

// Question à réponse numérique avec marge (intervalle marqué par des points)
::Q6:: Nommez un chiffre de 1 à 5. {#1..5}
// Lors de l'importation, cette question devient la même que Q5, mais non disponible dans l'interface de questions de Moodle.

// réponses numériques multiples avec points partiels et rétroaction
::Q7:: En quelle année est né Ulysses S. Grant? {#
         =1822:0      # Bravo! Tous les points.
         =%50%1822:2  # Il est né en 1822. Votre réponse était proche, vous avez la moitié des points.
}

// Composition
::Q8:: Comment allez-vous? {}

Explication des symboles

Dans le format choix multiple, les barres de commentaires // pour la question se transforment en numéro ID unique lors de l'exportation.

La première paire de :: précède le titre de la question.

La deuxième paire de :: précède la question. La première accolade { indique le début des réponses. Les bonnes réponses sont précédées de = et les mauvaises réponses sont précédées de ~. Les rétroactions de l'enseignant commencent par un #. La question se termine par } et une ligne vide. Veuillez noter qu'il s'agit d'accolades { } et non de parenthèses ( )!

//Commentaires 
::Titre de la question 
:: Question {
=Bonne réponse
~Mauvaise réponse 1
#Rétroaction pour la mauvaise réponse 1
~Mauvaise réponse 2
#Rétroaction pour la mauvaise réponse 2
~Mauvaise réponse 3
#Rétroaction pour la mauvaise réponse 3
~Mauvaise réponse 4
#Rétroaction pour la mauvaise réponse 4
}

Le plus petit format pour une question à choix multiple est :

Question{=Bonne réponse ~Mauvaise réponse 1 ~Mauvaise réponse 2 ~Mauvaise réponse 3 ~Mauvaise réponse 4}
Conseil : si vous ne précisez pas de titre pour votre question, la question COMPLÈTE sera utilisée comme titre lors de l'importation dans Moodle.
    • Désavantage : cela peut ajouter beaucoup de mots inutiles et peut inclure des caractères qui ne seront peut-être pas reconnus lors de l'exportation.
    • Avantages : Si chaque question commence d'une façon différente, cela peut faciliter la recherche d'une question parmi une catégorie de questions. Il n'est pas recommandé d'avoir le même titre pour toutes les questions.

Exemples de formats de questions

Il y a plusieurs façons d'utiliser un éditeur de texte pour écrire en format GIFT. Nous tenterons de montrer la version simple comme exemple et pour certains formats, nous introduirons quelques options plus complexes qui peuvent être importées dans différents formats de questions Moodle.

Choix multiple

Pour les questions à choix multiple, les mauvaises réponses sont précédées d'un tilde (~) et les bonnes réponses sont précédées d'un symbole d'égalité (=).

Voici un format GIFT simple de choix multiple acceptable : Qui repose dans la Grant's tomb? {=Grant ~Personne ~Napoléon ~Churchill ~Mère Teresa}

Voici un format plus long qui utilise davantage d'éléments GIFT :

 // Question : 1 Nom : Grant's tomb
::Grant's tomb::Qui repose dans la Grant's tomb à New-York? {
=Grant
~Personne
#C'était vrai pendant 12 ans, mais la dépouille de Grant a été enterrée dans cette tombe en 1897.
~Napoléon
#Il a été enterré en France.
~Churchill
#Il a été enterré en Angleterre.
~Mère Teresa
#Elle a été enterrée en Inde.
}

Choix multiple avec plusieurs bonnes réponses

Cela signifie que les boutons radio sont remplacés par des cases à cocher :

Parmi ces personnes, nommez-en deux qui sont enterrées dans la Grant's tomb. {
   ~%-100%Personne
   ~%50%Grant
   ~%50%L'épouse de Grant
   ~%-100%Le père de Grant
}

Vrai-faux

Dans ce type de question, la réponse indique si une proposition est vraie ou fausse. La réponse doit être écrite comme {TRUE} (vrai) ou {FALSE} (faux), ou abrégée {T} ou {F}.

// Question : 0 Nom : Proposition vraie
::Proposition vraie à propos de Grant::Grant a été enterré dans une tombe à New-York.{T}

// Question : 0 Nom : Proposition fausse
::Proposition fausse à propos du soleil::Le soleil se lève à l'Ouest.{FALSE}

Réponse courte

Les réponses d'une question de type réponse courte sont toutes précédées d'un symbole d'égalité (=), indiquant que toutes ces réponses sont bonnes. Les réponses ne doivent pas contenir de tilde.

Voici deux exemples utilisant la méthode simple de montrer les réponses possibles. Qui est enterré dans la Grant's tomb? {=Grant =Ulysses S. Grant =Ulysses Grant}

Deux plus deux égalent {=quatre =4 =IV}

S'il existe une seule bonne réponse, elle peut être écrite sans symbole d'égalité la précédant, en autant qu'elle ne puisse pas être confondue avec une question vrai-faux.

Appariement

Les différents appariements commencent par un symbole d'égalité (=) et sont séparés par ce symbole « -> ». Il doit y avoir au moins trois appariements (au moins trois éléments différents d'un côté et au moins deux éléments différents de l'autre).

Appariez les pays suivants avec les capitales correspondantes. {

   =Canada -> Ottawa
   =Italie -> Rome
   =Japon -> Tokyo
   =Inde -> New Delhi
   }

Les questions d'appariement ne peuvent pas inclure de rétroaction ni de pondération.

Mot manquant

Le format mot manquant insère automatiquement un trou au milieu d'une phrase. Pour utiliser le format mot manquant, mettez les réponses où vous voulez qu'un trou se crée dans le texte.

Il faut débourser {~beaucoup d'argent =rien du tout ~un petit montant d'argent} pour télécharger Moodle à partir de moodle.org.

Si les réponses arrivent avant le point dans la phrase, un trou sera inséré pour y saisir le mot manquant. Tous les types de questions peuvent être écrits dans le format mot manquant.

Il doit y avoir une ligne vide (double retour de chariot) entre les questions. Pour plus de clarté, les réponses peuvent être écrites sur des lignes séparées, voire indentées. Voici quelques exemples :

L'anniversaire de Mahatma Gandhi est une fête indienne célébrée le {

~15
~3
=2
} octobre.

Le 14 octobre {

  ~495 AD
  =1066 AD
  ~1215 AD
  ~43 AD
} a lieu la bataille d'Hastings, en Angleterre.

Questions à réponse numérique

La section réponse pour les questions à réponse numérique doivent commencer par un dièse (#). Les réponses numériques peuvent inclure une marge d'erreur, qui doit être mentionnée après le bonne réponse, et être précédée d'un deux-points (:). Ainsi, par exemple, si la bonne réponse peut être n'importe quel nombre entre 1,5 et 2,5, alors elle sera écrite comme {#2:0,5}. Ceci indique que 2 avec une marge d'erreur de 0,5 est la bonne réponse (c'est-à-dire l'empan entre 1,5 et 2,5). Si aucune marge d'erreur n'est mentionnée, elle sera de zéro.

Voici un simple format de question à réponse numérique. Elle tolérera une marge de 5 ans. En quelle année Ulysses S. Grant est-il né? {#1822:5} C'est une bonne idée de vérifier les limites de la marge. Par exemple, dans le prochain exemple, 3,141 n'est pas une bonne réponse et 3,142 est une bonne réponse selon la marge. Quelle est la valeur de pi (incluant 3 chiffres après la virgule)? {#3,14159:0,0005}.

Optionnellement, les réponses numériques peuvent être rédigées en tant qu'étendue comme dans cet exemple : {#valeur minimale..valeur maximale}.

Quelle est la valeur de pi (incluant 3 chiffres après la virgule)? {#3,141..3,142}.

Les questions à réponse numérique ayant plusieurs réponses numériques peuvent être utilisés pour déterminer de multiples empans numériques et peuvent être particulièrement utiles lorsqu'ils sont utilisés en combinaison avec une pondération en pourcentage. Si de multiples réponses sont utilisées, celles-ci doivent être séparées par un symbole d'égalité, comme les questions à réponse courte.

En quelle année est né Ulysses S. Grant? {#

   =1822:0
   =%50%1822:2
}

Composition

Une question de type composition est tout simplement une question avec un champ de réponse vide. Les accolades indiquant les réponses doivent rester vides, puisque ce type de question ne peut pas être corrigé automatiquement.

Écrivez une courte biographie de Dag Hammarskjöld. {}

Description

Une question de type Description n'a aucune réponse. Ce type de question ne sert qu'à insérer du texte fixe comme une consigne dans votre test.

Exemple : Vous pouvez utiliser un crayon et un papier pour les questions d'appariement suivantes.

Options

En plus de ces types de questions de base, ce filtre offre différentes options : lignes de commentaires, nom de la question, rétroaction et pondération de la question en pourcentage.

Lignes de commentaires

Des commentaires, qui ne seront pas importés dans Moodle, peuvent être inclus dans le fichier texte. Ils peuvent être utilisés pour créer des en-têtes ou donner de l'information sur les questions. Toutes les lignes commençant par une double barre oblique inverse (\\) (sans espace) seront ignorées par le filtre.

//Prochaines questions : questions numériques

Que font 2 plus 2? {#4}

Les commentaires seront exportés depuis Moodle et incluront un ID de question unique. La question suivante a été importée, puis exportée de Moodle :

// Question : 914  Nom : Que font 2 plus 2? 
::Que font 2 plus 2?::Que font 2 plus 2?{#
    =4:0#
}

Nom de la question

Un nom de question peut être précisé en le plaçant avant la question et entre double deux-points (::...::).

::Origines des kanji::Les sinogrammes japonais viennent de quel pays? {=China}
::Date du Thanksgiving américain::Aux États-Unis, le Thanksgiving est célébré le {~deuxième ~troisième =quatrième} jeudi de novembre.

Si aucun nom de question n'est précisé, la question entière sera utilisée comme nom par défaut.

Rétroaction

Une rétroaction peut être incluse pour chaque réponse en plaçant un dièse à la suite de la réponse (#) suivi de la rétroaction.

Quelle est la réponse à cette question à choix multiple? {
  ~Mauvaise réponse#Rétroaction pour cette mauvaise réponse
  ~Autre mauvaise réponse#Rétroaction pour cette autre mauvaise réponse
  =Bonne réponse#Très bien!
}
 
//Selon H2G2, « l'ultime réponse à la vie, l'univers et le reste » est {
  =quarante-deux#Bonne réponse selon H2G2!
  =42#Exact,tel que communiqué à Loonquawl et Phouchg.}

   42 est la réponse absolue à tout.{
FALSE#42 est l'ultime réponse.#C'est la bonne réponse.}

Pour les questions à choix multiple, la rétroaction est affichée seulement pour les réponses que l'étudiant a choisi. Pour les réponses vrai ou faux, il peut y avoir une ou deux rétroactions (bonne et mauvaise réponse).

Pourcentage des points selon la réponse

Il est possible de donner différents pourcentages des points selon la réponse dans les questions à choix multiple et à réponse courte. Le pourcentage des points selon la réponse peut être précisé en faisant suivre le tilde (pour les questions à choix multiple) ou le symbole d'égalité (pour les questions à réponse courte) par le pourcentage des points accordé entre symboles de pourcentage (exemple : %50%). Cette option peut être combinée à une rétroaction.

Question difficile.{~Mauvaise réponse ne valant aucun point~%50%Réponse valant la moitié des points=Bonne réponse valant tous les points}

::Ville de Jésus::Jésus a grandi dans la ville de {
   ~Jérusalem#C'était une ville importante, mais ce n'est pas la bonne réponse.
   ~%25%Bethléhem#C'était sa ville de naissance, mais ce n'est pas l'endroit où il a grandi.
   ~%50%Galilée#Vous devez être plus précis.
   =Nazareth#Oui, c'est la bonne réponse!
}.
    
::Ville de Jésus::Jésus a grandi dans la ville de {
   =Nazareth#Oui, c'est la bonne réponse!
   =%75%Nazarette#Bonne réponse, mauvaise orthographe.
   =%25%Bethléhem#C'était sa ville de naissance, mais ce n'est pas l'endroit où il a grandi.
}

Veuillez noter que ces deux exemples montrent la même question, mais le premier montre une question à choix multiple et le deuxième montre une question à réponse courte.

Veuillez également noter qu'il est possible de préciser un pourcentage qui n'est pas normalement offert dans l'interface. Le menu déroulant Faire correspondre les notes sur la page d'importation permet de déterminer comme gérer ces différences. Vous pouvez demander d'obtenir un message d'erreur ou que le pourcentage soit ajusté au plus près pourcentage.

Formatage du texte pour la question Le formatage du texte de la question (seulement) peut être précisé. Actuellement, les formats disponibles sont Moodle (Moodle Auto-Format), HTML (HTML format), plain (Plain text format) et markdown (Markdown format). Le format est précisé entre crochets [] avant le texte de la question. Par exemple :

[markdown]*Aux États-Unis, le Thanksgiving* est célébré le {
   ~deuxième
   ~troisième
   =quatrième
} jeudi de novembre.

Plusieurs réponses possibles

L'option plusieurs réponses possibles est utilisée dans la question à choix multiple lorsque deux réponses ou plus doivent être sélectionnées pour obtenir tous les points. L'option plusieurs réponses possibles s'applique en accordant un pourcentage partiel des points pour différentes réponses, mais sans accorder tous les points pour une seule réponse.

Qui sont les deux personnes qui sont enterrés dans la Grant's tomb? {
   ~Personne
   ~%50%Grant
   ~%50%L'épouse de Grant
   ~Le père de Grant
}

Veuillez noter qu'il n'y a pas de symbole d'égalité (=) pour aucune question et que les réponses doivent totaliser ni plus ni moins 100 % sans quoi vous recevrez un message d'erreur de Moodle. Pour éviter que les étudiants n'obtiennent 100 % en cochant toutes les réponses, il est recommandé d'inclure des pointages négatifs pour les mauvaises réponses.

Qui sont les deux personnes qui sont enterrés dans la Grant's tomb? {

   ~%-50%Personne
   ~%50%Grant
   ~%50%L'épouse de Grant
   ~%-50%Le père de Grant
}

Special Characters ~ = # { }

These symbols ~ = # { } : control the operation of this filter and cannot be used as normal text within questions. Since these symbols have a special role in determining the operation of this filter, they are called "control characters." But sometimes you may want to use one of these characters, for example to show a mathematical formula in a question. The way to get around this problem is "escaping" the control characters. This means simply putting a backslash (\) before a control character so the filter will know that you want to use it as a literal character instead of as a control character. For example:

Which answer equals 5? {
   ~ \= 2 + 2
   = \= 2 + 3
   ~ \= 2 + 4
}
::GIFT Control Characters::
Which of the following is NOT a control character for the GIFT import format? {
  ~ \~     # \~ is a control character.
  ~ \=     # \= is a control character.
  ~ \#     # \# is a control character.
  ~ \{     # \{ is a control character.
  ~ \}     # \} is a control character.
  = \      # Correct! \ (backslash) is not a control character. BUT,
             it is used to escape the control characters.
}

When the question is processed, the backslash is removed and is not saved in Moodle.

Specifying Categories

It is possible to change the category into which the questions are added within the GIFT file. You can change the category as many times as you wish within the file. All questions after the modifier up to the next modifier or the end of the file will be added to the specified category. Up to the first category modifier the category specified on the import screen will be used. Note that for this to work the from file: box must be ticked on the import screen.

To include a category modifier include a line like this (with a blank line before and after):

$CATEGORY: tom/dick/harry

or simply

$CATEGORY: mycategory

...the first example specifies a path of nested categories. In this case the questions will go into harry. The categories are created if they do not exist.

Making questions case sensitive

Short Answer questions can be made case sensitive by changing "0" to "1" in the following line of your moodle/question/format/gift/format.php file:

$question->usecase = 0; // Ignore case

Hints and Tips

  • Use the ::title:: at the beginning of every question to organize your questions when Moodle presents a list or exports them as another GIFT file. When the title is left blank, Moodle will put the beginning of the question as the title. Some teachers want to see something like "001 LIT101 Poe ref Purloin Letter" or "The Purloin Letter was written by (AmLit pg 254)" in the title.
  • You can specify markup if you need to format the question by setting [html], [moodle], [plain] or [markdown] just before the question text. See more about this in the reference pdf below.
  • In the Lesson module, in a question page, correct answers jump by default to Next page and incorrect answers jump to This page (i.e. student has to "try again"). When importing from a GIFT format file, this is exactly the mechanism which is used.
  • If you want a student to be taken directly from one question to the next irrespective of their answer being correct or incorrect: in the Lesson Settings, set Maximum number of attempts: to 1.
    • Please note, however, that a message "correct / incorrect" will still be displayed to the student upon answering each question. If you do not want this (default) feedback message to be displayed then enter your own feedback message (i.e. "continue", "---", etc.)
    • In case you want no visible message displayed then enter a non-breaking space as feedback. Moodle will not put it's automatic response because it sees the blank space. To do this, put a # after the answer and write Fichier:Nbsp.png (without spaces between these characters).
  • Need to use a special GIFT character in your question or answer? Put a \ in front of the GIFT character.
    • For example if you want to use curly braces, { or }, or equal sign, =, or # or ~ in a GIFT file (in a math question including TeX expressions) you must "escape" them by preceding them with a \ directly in front of each { or } or =. It is possible to use a replace program/macro/editor filter to do this conversion before importing to Moodle.
  • Want to change T/F type questions to multiple choice? Consider exporting the T/F questions as a GIFT file, then using a text editor to replace the (T) with (=True ~False). Perhaps change the title slightly so you will recognize the new questions.
  • Alphabetic case-sensitive comparison is disabled by default. If you need case-sensitive comparison for short answer questions (an unusual need), precede them with:
  $question->usecase = 1;

surrounded by blank lines.

Liens externes