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 utilis√©s ensemble dans un seul fichier texte. Le format permet √©galement l'insertion de commentaires, de titres de questions, de feedbacks et de coefficients.

L'encodage de votre fichier doit être UTF-8 (à moins que vous n'utilisiez que des caractères ASCII). Un exemple de fichier de questions peut être téléchargé ici : gift/examples.txt.

Préambule

Chaque question d'un fichier GIFT ne doit pas contenir de ligne vide, car les lignes vides servent √† d√©limiter par les lignes vides. Si vous devez afficher une ligne vide dans votre question, vous pouvez utiliser la notation \n. Des lignes de commentaires peuvent √™tre ajout√©s n'importe o√Ļ dans le fichier, mais elles doivent commencer alors par deux barres obliques (//) au d√©but de la ligne.

Types de questions

Choix multiples

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

     Quel est le nom du h√©ros du Comte de Monte-Cristo¬†?{~Jean Valjean ~√Čtienne Lantier =Edmond Dant√®s}

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.

     Le héros du Comte de Monte-Cristo s'appelle {~Jean =Edmond ~Philippe} Dantès.

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é :

     L'histoire des Trois Mousquetaires se déroule au {
     ~quinzième
     ~seizième
     =dix-septième
     } siècle.

     De quelle pays sont originaires les caractères japonais ? {
     ~Inde
     =Chine
     ~Corée
     ~√Čgypte}

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.

     Quel est le nom du héros du Comte de Monte-Cristo ?{=Dantès =Edmond Dantès}

     Deux plus deux égale {=quatre =4 =IV =Quatre}.

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

     √Čtienne Lantier est le h√©ros du Comte de Monte-Cristo.{F}

     Le Soleil se l√®ve du c√īt√© Est.{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.

     Question d'appariement. {
     =Terme 1 -> Correspondance 1
     =Terme 2 -> Correspondance 2
     =Terme 3 -> Correspondance 3
     }

     Faites correspondre les pays ci-dessous avec leur capitale. {
     =Canada -> Ottawa
     =Italie -> Rome
     =Japon  -> Tokyo
     =Inde   -> New Delhi
     }

Les questions d'appariement ne permettent ni 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.

     
     En quelle année est né Wolfgang Amadeus Mozart ? {#1756}

     Quelle est la valeur de ŌÄ (3 d√©cimales)¬†? {#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 ŌÄ (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.

     En quelle année est né Wolfgang Amadeus Mozart ? {#
     =1756:0
     =%50%1756: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 !).

Composition

Une question de composition est simplement une question dont le champ réponse est vide. Il ne faut rien écrire du tout entre les deux accolades.

     √Čcrire une br√®ve biographoie de Wolfgang Amadeus Mozart. {}

Description

Une description n'est pas vraiment une question, puisqu'elle ne comporte pas de réponse du tout. Elle permet d'indiquer un commentaire entre des questions du test.

     Les questions ci-dessous auront pour sujet le roman Les trois Mousquetaires.

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.

     // Sous-titre : voici une question numérique
     Combien font 2 + 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.

     
     ::Origine des caractères Kanji::De quel pays sont originaires les
     les caractères japonais Kanji ? {=Chine}

     ::Période des Trois Mousquetaires::L'histoire des Trois Mousquetaires
      se déroule au {~quinzième ~seizième =dix-septième} siècle.

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

     Quelle est a réponse à cette question à choix multiples ?{
     ~réponse fausse#Feedback pour la réponse fausse
     ~autre réponse fausse#Autre feedback pour cette réponse fausse
     =bonne réponse#Excellent !}

     Quel est le nom du héros du Comte de Monte-Cristo ?{
     =Dantès#Excellente réponse !
     =Edmond Dantès#Excellente réponse !}

     √Čtienne Lantier est le h√©ros du Comte de Monte-Cristo.{
     FALSE#Faux, il s'agit de Edmond Dantès.
     #En effet, c'est Edmond Dantès}

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, il peut y avoir une ou deux cha√ģnes pour le feedback. La premi√®re est affich√©e si la r√©ponse donn√©e est incorrecte, la deuxi√®me si la r√©ponse est fausse.

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}

     ::Résidence de Jésus::Jésus Christ résidait à {
     ~Jérusalem#C'était une ville importante, mais de la mauvaise réponse.
     ~%25%Bethléhem#Il y est né, mais n'y a pas grandi.
     ~%50%Galilée#Soyez plus précis.
     =Nazareth#Oui ! C'est cela !}.

     ::Résidence de Jésus:: Jésus Christ résidait à {
     =Nazareth#Oui ! C'est cela !
     =%75%Nazireth#Juste, mais mauvaise orthographe.
     =%25%Bethléhem#Il y est né, mais n'y a pas grandi.}

Les deux derniers exemples sont en fait une même question, une première fois 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. Le menu Correspondance des notes sur la page d'importation détermine comment de tels coefficients sont traités. Vous pouvez soit demander qu'une erreur soit affichée, soit que le coefficient soit ajusté au plus proche d'un coefficient valable pour la question.

Spécifier un format texte pour la question

Le texte de la question (et seulement ce texte) peut comporter un texte optionnel spécifiant son format. Les formats actuellement disponibles sont moodle (format automatique Moodle), html (format HTML), plain (texte pur) et markdown (format Markdown). Le format doit être indiqué entre crochets immediatement avant le texte de la question. Plus d'informations sur les formats de texte dans Moodle.

::Période des Trois Mousquetaires::L'histoire des Trois Mousquetaires se déroule au {~quinzième ~seizième =dix-septième} siècle.
     [markdown]L'histoire des *Trois Mousquetaires* se déroule au {
     ~quinzième
     ~seizième
     =dix-septième
     } siècle.

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.

     Les personnages suivants apparaissent dans les Trois mousquetaires ? {
     ~L'abbé Faria
     ~%50%Constance Bonacieux
     ~%50%L'abbé d'Herblay
     ~Le capitaine Némo}

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.

     Les personnages suivants apparaissent dans les Trois mousquetaires ? {
     ~%-50%L'abbé Faria
     ~%50%Constance Bonacieux
     ~%50%L'abbé d'Herblay
     ~%-50%Le capitaine Némo}

Caractères spéciaux ~ = # { } :

Ces symboles ~ = # { } : contr√īlent le fonctionnement de ce filtre et ne peuvent pas √™tre utilis√©s comme du texte normal √† l'int√©rieur des questions. Ils sont appel√©s des caract√®res de contr√īle. Vous aurez parfois besoin d'utiliser l'un de ces caract√®res, par exemple pour afficher une formule math√©matique dans une question. Pour pouvoir contourner ce probl√®me en ¬ę¬†√©chappant¬†¬Ľ ces caract√®res de contr√īle. Cela signifie simplement placer une barre oblique inverse (\) avant le caract√®re en question, de sorte que le filtre l'utilisera comme un caract√®re litt√©ral plut√īt que comme un caract√®re de contr√īle. Par exemple¬†:

     Quelle opération donne 5 ? {
          ~ \= 2 + 2
          = \= 2 + 3
          ~ \= 2 + 4  }

     ::Caract√®res de contr√īle GIFT::
     Lequel des caract√®res suivants n'est pas un caract√®re de contr√īle pour 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 "√©chapper" les caract√®res de contr√īle.
     }

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

Indiquer des catégories

Il est possible de modifier la catégorie dans laquelle les questions seront ajoutées, en l'indiquant dans le fichier d'importation GIFT. Vous pouvez changer cette catégorie autant de fois que vous le voulez à l'intérieur de ce fichier. Toutes les questions après l'indication de catégorie jusqu'à la prochaine indication (ou la fin du fichier) seront ajoutées à la catégorie indiquée. La catégorie spécifiée dans l'interface d'importation sera utilisée jusqu'à la première indication dans le fichier. Pour que ceci fonctionne, il est nécessaire de cocher la case Depuis le fichier : dans l'interface d'importation.

Pour indiquer les catégories dans le fichier, placez-y une ligne comme ci-dessous (avec une ligne vide avant et après).

$CATEGORY: sciences/maths/analyse
or simply
$CATEGORY: latin
Le premier exemple indique une catégorie située dans une autre, etc. Dans l'exemple ci-dessus, les questions seront placéesdans la catégorie analyse. Les catégories seront créées si elles n'existent pas.

Autres options

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

Index général de l'aide
Afficher cette aide dans la langue : English