Importer des fichiers en format « GIFT »

Le format GIFT est le format le plus exhaustif pour l'importation de questions dans le module de tests de Moodle. Il permet l'importation de questions à Choix multiples, Vrai/Faux, à Réponses courtes, d'Appariement et Numériques, ainsi que l'insertion de _____ pour le format « Mot manquant ». Les différents types de questions peuvent être mélangés dans un seul fichier texte. Le format permet également l'insertion de commentaires, titres de questions, feedbacks et de coefficients.

### Types de questions

#### À Choix multiples

Pour les questions à choix multiples, les mauvaises réponses sont préfixées d'un tilde (~) et la réponse correcte d'un signe égal (=).

         Who's buried in Grant's tomb?{~Grant ~Jefferson =no one}

Le format Mot manquant insère automatiquement une ligne à compléter (comme cela _____) au milieu du texte. Pour obtenir ce résultat, placez les réponses là où vous voulez que la ligne apparaisse. Les signes _____ ne sont insérés que si les réponses sont placées avant la ponctuation finale.

         Grant is {~buried =entombed ~living} in Grant's tomb.

Tous les types de questions permettent ce format Mot manquant.

Une ligne vide (deux retours de chariot) doit séparer les différentes questions. Les réponses peuvent être écrites sur des lignes séparées et même indentées, dans un souci de clarté :

         The American holiday of Thanksgiving is celebrated on the {
         ~second
         ~third
         =fourth
         } Thursday of November.

         Japanese characters originally came from what country? {
         ~India
         =China
         ~Korea
         ~Egypt}

#### Réponse courte

Dans ce format, les réponses sont toutes préfixées d'un signe égal (=), indiquant que toutes sont correctes. Les réponses ne peuvent contenir de tilde.

         Who's buried in Grant's tomb?{=no one =nobody}

         Two plus two equals {=four =4}.

S'il n'y a qu'une seule bonne Réponse courte, elle peut être écrite sans le signe égal, à moins qu'elle ne puisse être confondue avec une question Vrai/Faux.

#### Vrai/Faux

La réponse indique ici lequel des énoncés est vrai ou faux. La réponse s'écrit {TRUE} ou {FALSE}, ou de façon abrégée {T} ou {F}.

         Grant is buried in Grant's tomb.{F}

         The sun rises in the east.{T}

#### Appariement

Les paires correspondantes doivent commencer par un signe égal (=) et sont séparées par le symbole « -> » (sans les guillemets). Il doit y avoir au moins trois paires.

         Matching Question. {
         =subquestion1 -> subanswer1
         =subquestion2 -> subanswer2
         =subquestion3 -> subanswer3
         }

         Match the following countries with their corresponding capitals. {
         =Canada -> Ottawa
         =Italy  -> Rome
         =Japan  -> Tokyo
         =India  -> New Delhi
         }

Les questions d'appariement ne permettent pas les feedbacks, ni les coefficients.

#### Numérique

La réponse d'une question numérique doit commencer par le signe dièze (#). Elle peut contenir une marge d'erreur, écrite immédiatement après la réponse correcte, séparée par un signe deux-points (:). Si par exemple la réponse est située entre 1.5 et 2.5, on écrira {#2:0.5}. Si aucune marge d'erreur n'est spécifiée, elle est assimilée à 0.

         When was Ulysses S. Grant born? {#1822}

         What is the value of pi (to 3 decimal places)? {#3.1415:0.0005}.

On peut aussi donner la réponse numérique sous la forme d'un intervalle de la façon suivante : {#minimum..maximum}.

         Quelle est la valeur de pi (3 décimales) ? {#3.141..3.142}.

L'interface graphique (navigateur) de Moodle ne permet pas les réponses numériques multiples, mais le code de Moodle les permet, tout comme le format GIFT. On peut ainsi spécifier différents intervalles numériques, ce qui est particulièrement utile en le combinant avec des coefficients. Si plusieurs réponses numériques sont utilisées, elles doivent être séparées par un signe égal (=), comme les réponses courtes.

         When was Ulysses S. Grant born? {#
         =1822:0
         =%50%1822:2}

Comme l'interface de Moodle ne permet pas les réponses multiples pour les questions numériques, il n'y a aucun moyen de les voir, ni de les modifier autrement qu'en supprimant et en ré-important la question, ou en modifiant directement la base de données (DANGER !).

### Options

En plus de ces types de questions, les options suivantes sont offertes grâce à ce format : commentaires, nom de question, feedback et coefficients.

#### Commentaires

Les commentaires ne seront pas importés dans Moodle. Il servent à documenter les questions. Toutes les lignes de commentaire commencent par une double barre oblique (sans compter les espaces ou tabulations qui précèdent). Ces lignes seront simplement ignorées lors de l'importation.

         // Subheading: Numerical questions below
         What's 2 plus 2? {#4}

#### Nom de question

Un nom de question peut être indiqué en le plaçant avant la question, entouré par des double deux-points.

         ::Kanji Origins::Japanese characters originally
         came from what country? {=China}

         ::Thanksgiving Date::The American holiday of Thanksgiving is
         celebrated on the {~second ~third =fourth} Thursday of November.

Si aucun nom de question n'est donné, la question elle-même est utilisée par défaut.

#### Feedback

Un feedback peut être inclus avec chaque réponse. Il suffit de placer le feedback immédiatement après la réponse, séparé par un dièze (#).

         What's the answer to this multiple-choice question?{
         ~wrong answer#feedback comment on the wrong answer
         ~another wrong answer#feedback comment on this wrong answer
         =right answer#Very good!}

         Who's buried in Grant's tomb?{
         =no one#excellent answer!
         =nobody#excellent answer!}

         Grant is buried in Grant's tomb.{FALSE#No one is buried in Grant's tomb.}

Pour les questions à choix multiples, le feedback n'est affiché que pour la réponse sélectionnée par l'étudiant. Pour la réponse courte, le feedback est affichée uniquement si l'étudiant a donné la réponse correcte correspondante. Pour les questions Vrai/Faux, le feedback n'apparaît que si la réponse donnée est incorrecte. Dans le dernier exemple ci-dessus, le feedback ne s'affichera donc que si l'étudiant a sélectionné VRAI comme réponse.

#### Coefficients (en %)

Les coefficients sont disponibles pour les questions à choix multiples et pour les questions à réponse courte. Les coefficients peuvent être inclus en faisant suivre le tilde (pour les questions à choix multiples) ou le signe égal (pour les questions à réponse courte) par le pourcentage désiré, entouré de signes pour-cent (par exemple %50%). Cette option peut être combinée avec les feedbacks.

         Une question.{
         ~Réponse fausse
         ~%50%Réponse valant la moitié des points
         =Réponse donnant tous les points}

         ::Jesus' hometown::Jesus Christ was from {
         ~Jerusalem#This was an important city, but the wrong answer.
         ~%25%Bethlehem#He was born here, but not raised here.
         ~%50%Galilee#You need to be more specific.
         =Nazareth#Yes! That's right!}.

         ::Jesus' hometown:: Jesus Christ was from {
         =Nazareth#Yes! That's right!
         =%75%Nazereth#Right, but misspelled.
         =%25%Bethlehem#He was born here, but not raised here.}

Les deux derniers exemples sont une même question, une première foius comme question à choix multiples, la deuxième sous la forme de question à réponse courte.

Il est possible de spécifier ainsi des coefficients non disponibles dans l'interface graphique (navigateur) de Moodle. De tels coefficients seront calculés correctement d'après les valeurs données dans le fichier importé) et apparaîtront normales aux étudiants faisant le test. Cependant ces coefficients n'apparaîtront pas corrects pour les enseignants lors de l'édition des questions dans Moodle. Si vous éditez de telles questions avec l'interface de Moodle et que vous modifiez le coefficient, celui-ci sera changé.

#### Réponses multiples

L'option réponses multiples est utilisée pour des questions à choix multiples ou deux ou plusieurs réponses doivent être choisies afin d'obtenir tous les points. On active cette option en donnant aux diverses réponses des coefficients, aucune réponse ne donnant le total des points.

         What two people are entombed in Grant's tomb? {
         ~No one
         ~%50%Grant
         ~%50%Grant's wife
         ~Grant's father }

On remarque qu'il n'y a aucun signe égal dans aucune réponse. Le total des coefficients ne doit pas excéder 100%, sans quoi une erreur surviendrait dans Moodle. Pour éviter que les étudiants obtiennent 100% en sélectionnant systématiquement toutes les réponses, il est conseillé d'inclure des coefficients négatifs pour les réponses fausses.

         What two people are entombed in Grant's tomb? {
         ~%-50%No one
         ~%50%Grant
         ~%50%Grant's wife
         ~%-50%Grant's father }

#### Autres options

D'autres options sont disponibles en éditant le filtre d'importation gift/format.php.

Les réponses courtes peuvent être rendues sensibles à la casse des caractères en remplaçant « 0 » par « 1 » dans la ligne suivante :

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

### Des erreurs ?

L'encodage de votre fichier texte doit être le même que celui de votre installation Moodle.

Un fichier contenant des exemples de questions est à disposition ici : gift/examples.txt.

### Remerciements

Ce filtre d'importation a été écrit en collaboration avec de nombreux membres de la communauté Moodle. Il était basé à l'origine sur le format « mot manquant », qui comportait du code de Martin Dougiamas, Thomas Robb et d'autres personnes. Paul Tsuchido Shew a écrit ce filtre en décembre 2003, y incorporant les suggestions de la communauté, afin d'obtenir un format d'importation robuste. Le nom est un acronyme pour « General Import Format Technology » ou quelque chose comme ça. Comme c'est trop long, c'est juste GIFT !

GIFT documentation by Paul Tsuchido Shew, 13 Jan 2004, traduite par Nicolas Martignoni, 8 février 2004.