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
#### Permet de générer un feed-back général
{# 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
}

Précisons que si le pourcentage n'est pas un nombre entier (par exemple pour 3 bonnes réponses) il faut écrire le nombre suivi de 5 chiffres après la virgule (le séparateur utilisé doit être le "point" et non la "virgule"). Exemple :

question {
~%33.33333%Bonne réponse
~%33.33333%Bonne réponse
~%33.33333%Bonne réponse
~%0%Mauvaise réponse
~%0%Mauvaise réponse
}

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).

Feed-back général

Le feed-back général peut être inclus pour chaque question en plaçant 4 dièses à la suite avant la parenthèse finale.

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 !
####Feed-back général pour toute réponse donnée à cette question.
}

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
}

Caractères spéciaux ~ = # { }

Ces symboles ~ = # { } : contrôlent le fonctionnement de ce filtre et ne peuvent pas être utilisés comme texte normal à l'intérieur des questions. Puisque ces symboles ont un rôle spécial dans le fonctionnement du filtre, on les appelle « caractères de contrôle ». Mais parfois, vous pourriez vouloir utiliser l'un de ces caractères. Par exemple, pour montrer une formule mathématique dans une question. La façon d'éviter d'activer ces caractères de contrôle est de mettre une barre oblique inverse (\) avant le caractère de contrôle afin que le filtre sache que vous voulez l'utiliser comme caractère littéral et non comme contrôle. Par exemple :

Laquelle de ces formules égale 5 ? {
~ \= 2 + 2
= \= 2 + 3
~ \= 2 + 4
}
::Caractères de contrôle GIFT::
Lequel de ces caractères n'est PAS un caractère de contrôle dans le format d'importation GIFT ? {
~ \~     # \~ est un caractère de contrôle.
~ \=     # \= est un caractère de contrôle.
~ \#     # \# est un caractère de contrôle.
~ \{     # \{ est un caractère de contrôle.
~ \}     # \} est un caractère de contrôle.
= \      # Correct! \ (La barre oblique inverse) n'est pas un caractère de contrôle, MAIS, elle est utilisée pour éviter l'activation des caractères de contrôle.
}

Lorsque la question est importée, la barre oblique inverse est supprimée et n'est pas enregistrée dans Moodle.

Préciser des catégories

On peut modifier la catégorie dans laquelle les questions sont ajoutées à l'intérieur du fichier GIFT. Vous pouvez modifier la catégorie autant de fois que vous le voulez à l'intérieur du fichier. Toutes les questions après le début du modificateur et jusqu'au prochain modificateur ou la fin du fichier seront ajoutées à la catégorie mentionnée. Les questions du début du fichier jusqu'au premier modificateur Useront placées dans la catégorie précisée dans l'écran d'importation. Veuillez noter que pour que tout fonctionne, la case Obtenir la catégorie à partir du fichier doit être cochée dans l'écran d'importation.

Pour inclure un modificateur de catégorie, insérez une ligne comme celle-ci (entre deux lignes vides) :

$CATEGORY: tom/dick/harry

ou simplement

$CATEGORY: Macatégorie

...le premier exemple précise le chemin d'accès vers une sous-catégorie. Dans ce cas, les questions iront dans la sous-catégorie « Harry » La catégorie sera créée si elle n'existe pas.

Créer des questions sensibles à la casse

Les questions à réponse courte peuvent être sensibles à la casse si vous changez le « 0 » pour un « 1 » à la ligne suivante de votre fichier moodle/question/format/gift/format.php :

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

Conseils

  • Utilisez le ::titre:: au début de chaque question pour organiser l'ordre d'affichage de vos questions dans une liste ou dans un autre fichier GIFT. Lorsque le titre est laissé vide, Moodle met le texte de la question comme titre.
  • Vous voulez modifier vos questions de type vrai ou faux en questions à choix multiple? Exportez vos questions V/F en GIFT, utilisez un éditeur de texte pour remplacer le (T) par (=vrai ~faux), modifiez le titre légèrement pour pouvoir reconnaître la question modifiée, puis importez le fichier.

Format GIFT avec des médias (images, sons...)

Le plugin tiers GIFT avec des médias est un format d'import de questions similaire au format d'import Gift et il utilise la même syntaxe, mais au lieu d'un fichier texte (.txt) il permet d'importer une archive (.zip) contenant le fichier texte au format GIFT et des fichiers de médias (images, sons, ...). Une documentation explique comment inclure les médias dans les questions.

Liens externes