"GIFT"-Format-Dateien importieren

GIFT ist das umfangreichste Format zum Import von Textdateien in das Moodle Quiz-Modul. Es unterstützt Multiple-Choice-Fragen, Richtig-Falsch- Fragen, Kurzantwort-Fragen, Zuordnungen und Numerische Fragen, genauso wie Fragen mit Lückentexten. Verschiedene Fragenanrten können in einer Textdatei kombiniert werden. Das Importformat unterstützt auch Kommentarzeilen, Fragenamen, Feedback und die prozentuale Gewichtung der Antworten.

### Verschiedene Frageformen

Multiple-Choice-Fragen:
Für Multiple-Choice-Fragen wird das Tilde-Zeichen (~) verwandt, um falsche Antworten zu kennzeichnen. Richtige Antworten werden mit dem Gleichheitszeichen (=) markiert.

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

### Lückentexte

Das Lückentextformat füllt automatisch ein unterstrichenes Leerfeld (wie _____) in den Satz. Die Reihenfolge der Antwortvorgaben ist beliebig. Richtige und falsche Antworten werden wieder mit Tilde (~) und Gleichheitszeichen markiert.

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

Wenn die Antwort vor der schließenden geschweiften klammer kommt, wird ein unterstrichenes Leerfeld für den Lückentext eingefügt. Alle Fragetypen können in diesem Format geschrieben werden.

Zwei Fragen werden durch die Eingabe von zwei aufeinander folgenden Absatzzeichen getrennt. Zur Verdeutlichung, die Antworten können auch in separtaen Zeilen eingegeben werden. Beispiel:

         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}

Kurzantwort-Fragen:
Antworten im Kurzantzwortfragen-Format werden alle durch ein Gleichheitszeichen (=) eingeleitet, das verdeutlicht, dass alle Antworten richtig sind. Falsche Antwortvorgaben (~) sind nicht erforderlich.

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

         Two plus two equals {=four =4}.

Wenn es nur eine richtige Antwort gibt, kann auf das Gleichheitszeichen für die richtige Antwort verzichtet werden, solange keine Verwechslung mit Richtig-Falsch Fragestellung erfolgen kann.

Richtig-Falsch-Fragen:
Bei diesem Fragetyp kennzeichnet die antwort, ob die Aussage richtig oder falsch ist. Die Antwort sollte als richtig {TRUE} oder falsch {FALSE}, oder abgekürzt {T} oder {F} gekennzeichnet werden.

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

         The sun rises in the east.{T}

Zuordnungen:
Zuordnungspaare beginnen mit einem Gleichheitszeichen (=) und werden durch das Pfeilsymbol "->" voneinander getrennt. Es sind mindestens drei Vergleichspaare erforderlich.

         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
             }

Feedback und die prozentuale Gewichtung der Antworten werden hier nicht unterstützt.

Numerische Fragen:
Der Antwortabschnitt für eine numerische Antwort muß mit dem Rautenzeichen (#) beginnen. Nicht exakt richtige, aber akzeptierte Antworten können ebenfalls eingegeben werden. Sie folgen der richtigen Antwort und einem Doppelpunkt. Wenn z.B. die richte Antwort zwischen 1,5 und 2,5 liegt dann erfolgt diese Eingabe {#2:0.5}. Das bedeutet 2 mit einer Fehlertoleranz von 0,5 ist korrekt. Wenn keine Fehlertoleranz angegeben wird, wird nur die genaue Antwort als richtig gewertet.

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

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

Zusätzlich können Zahlenantworten auch als Spanne von..bis eingegeben werden. Schreiben Sie dazu in diesem Format {#MinimumValue..MaximumValue}.

         What is the value of pi (to 3 decimal places)? {#3.141..3.142}.

Moodle's Browseroberfläche unterstützt keine Antworten mit verschiedenen richtigen Zahlen. Der Code kann dies jedoch verabeiten und daher ermöglicht das GIFT Format eine Definition derartiger Fragen und Antworten. Dies ist erforderlich wenn verschiedene Antwortspannen richtig sind oder zum Teil auch wenn verschiedene Antworten unterschiedliche Prozentwerte bei der Bewertung ergeben. Verschiedene Antworten müssen durch ein Gleichheitszeichen voneinander getrennt sein wie bei den Kurzantwortfragen.

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

Hinweis: diese Option wird in der Verwaltung von Moodle-Quiz nicht unterstützt und nicht angezeigt. Der einzige Weg, solche Fragen zu ändern ist durch Löschen der Frage im Moodle-Quiz-Modul und Re-Import der veränderten Frage (oder direkt in phpMyAdmin).

### Optionen

Zusätzlich zu diesen Frageformen bietet dieser Filter folgende Optionen: Kommentarzeilen, Fragenamen, Feedback und eine prozentuale Gewichtung der Antworten bei der Bewertung.

Kommentarzeilen:
Alle Zeilen, die mit einem doppelten backlash-Zeichen (\\) beginnen, werden von diesem Filter ignoriert.

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

Fragenname:
Der Fragenname wird zu Beginn der Frage geschrieben und durch zweifache Doppelpunkte eingefasst.

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

Wenn kein Fragenname angegeben wird wird automatisch durch Voreinstellung eine Bezeichnung vergeben.

Feedback:
Feedback kann für jede Antwort definiert werden. Die Feedbackdefinition folgt der Antwort und wird durch ein(#) von ihr separiert.

         Waa ist die Antwort auf diese Multipli-Choice-Frage?{
         ~falsche Antwort#Feedback Kommentar zur falschen Antwort
         ~eine andere falsche Antwort#Feedback Kommentar zu dieser falschen Antwort
         =richtige Antwort#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.}

Bei Multiple-Choice-Fragen wird der Kommentar nur für die ausgewählte Antwort angezeigt. Bei Kurzantwortfragen wird der Kommentar nur bei der richtigen Antwort angezeigt. Bei Richtig-Falsch-Fragen wird ein Kommentar bei der falschen Antwort gezeigt. Im obigen Beispiel wird der Feedback-Kommentar nur bei der falschen Antwort (hier: richtig) angezeigt.

### Prozentuale Gewichtung der Antworten

Eine prozentuale Gewichtung der Antworten ist bei den Kurzantwortfragen und bei Multiple-Choice-Fragen möglich. Der Prozentwert folgt dem Tilde-Zeichen (bei Multiple-Choice-Fragen) oder dem Gleichheitszeichen (bei Kurzantwort Fragen). Eingegeben wird der Zahlwert zwischen den Prozentzeichen (%50%). Diese Option kann mit Komentaren kombiniert werden.

         Difficult question.{~wrong answer ~%50%half credit answer =full credit answer}

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

Die Beispiele sind die gleiche Frage als Multiple-Choice Frage und als Kurzantwort-Frage.

Hinweis: Hier können auch Prozentwerte angegeben werden, die bei Moodle im Quiz-Modul nicht erfasst werden können. Die Berechnung erfolgt dennoch richtig. Die Anzeige für den Trainer/innen in Moodle erfolgt u.U. jedoch nicht korrekt wenn sie innerhalb des Quizmoduls weiter bearbeitet wird. Die Anzeige für die Teilnehmer/innen ist dennoch richtig. Das Pulldownmenu in Moodle's Quiz-Modul erlaubt nur bestimmte Werte. Wenn der in der Import-Datei eingetragene Wert damit nicht völlig übereinstimmt erfolgt eine fehlerhafte Anzeige in der Ansicht von Moodle. Wenn Sie nun eine Bearbeitung des Quiz innerhalb von Moodle vornehmen wird der Wert entsprechend den Möglichkeiten von Moodle angepasst und geändert.

### Mehrere Antworten

Die Option Mehrere Antworten ermöglicht Fragen bei denen mehrere Antworten als richtig bezeichnet werden müssen, um die Antwort insgesamt als vollständig richtig zu beantworten. Damit nicht bei einer einzelnen abgegeben Antwort die volle Punktzahl vergeben wird, müssen alle richtigen Antworten mit einem entsprechenden Bewertungsgewicht versehen werden.

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

Hinweis: Es gibt kein Gleichheitszeichen (=) für eine Antwort und die Summe der Gewichtungen darf 100% nicht überschreiten, sonst erfolgt eine Fehlermeldung durch Moodle. Damit ein 100 % Wert nicht durch Anklicken aller Antworten ereicht wird, müssen negative Gewichtugen für falsche Antworten vergeben werden.

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

### Andere Optionen:

Andere Optionen sind durch Anpassung des Importfilters gift/format.php möglich.

Kurzantwortfragen können die Groß- und Kleinschreibung der Antworten berücksichtigen durch eine Änderung der Zeile
`$question->usecase = 0; // Ignore case`

### Troubleshooting

Die Textdateibezeichnung muß mit der Bezeichnung in Ihrer Moodle Installaton übereinstimmen.

Hier finden Sie einen Beispieltext: gift/examples.txt.

### Credits

Dieser Filter wurde gemeinsam von mehreren Mitgliedern der Moodle Community geschrieben. Ursprünglich wurde er für das Lückentextformat von Martin Dougiamas, Thomas Robb und anderen geschrieben. Paul Tsuchido Shew erweiterte den Filter im Dezember 2003 unter Mitwirkung von Vorschlägen aus der Community um weitere Frageformate. Der Name GIFT ist ein Akronym aus "General Import Format Technology" oder irgendsoetwas. Das ist aber für die Bezeichnung eines Filters zu lang: deshalb einfach GIFT.

GIFT documentation by Paul Tsuchido Shew, 13 Jan 2004.