导入“GIFT”格式文件

GIFT是Moodle从文本文件导入问题的通用格式。它支持单选题、是非题、简答题、匹配题、数学题及填空题。在一个单独的文本文件中可以添加多种类型的题目，这种格式还支持整行注释、问题名称、反馈和百分比权重。
您的文本编码必须是utf-8格式（除非您只使用ASCII字符）。以下是一个问题文本文件的例子:gift/examples.txt.

基础
GIFT文件里的每一个问题中不能包含空行。但问题之间至少有一个空行。如果在您的问题里需要一个空行您可以用：\n。

您可以在任何地方用注释，但是必须在这行注释前用双斜线（//）。

问题类型

单选题：

对于单选题：错误答案以波浪号(~)为前缀，正确答案以等号(=)为前缀。例如：

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

Missing Word格式可以在句子中自动插入一个填空线（像_____）。用Missing Word格式，可以根据需要，让填空线出现在句子的任何地方，答案就填在这条线上。例如：

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

如果答案出现在句号前，"missing word"格式会插入一个填空线。在 Missing Word格式中可以填写所有的问题类型。

 

必须有一个空行（双回车）把问题分开。为了表示清楚，答案要分行写。例如

     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}

简答：

在简答题中，答案前面都是以等号(=)为前缀，这表明它们都是正确答案。答案中不能包含波浪号前缀。例如：

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

     Two plus two equals {=four =4}.

如果只有一个正确的答案，只要不与是非题混淆，可以不写等号前缀。

是非题：

是非题的答案表明命题是对还是错。答案应该写成{TRUE} 或 {FALSE}，也可以简写成{T} 或{F}。例如：

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

     The sun rises in the east.{T}

匹配题：

匹配题以一个等号(=)开始，用符号“->”分开，至少包含三对匹配项。例如：

     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
         }

匹配题不支持反馈或答案的百分比权重。

数学题：

数学题的答案必须以数学符号(#)开始。数字答案可以包括一个误差容限（被一个冒号分开，写在正确答案之后）。例如：如果正确答案在1.5和2.5之间，这时可以写成{#2:0.5}。这表明2在0.5的误差容限内是正确的（例如：从1.5到2.5这个范围）。如果没有详细说明误差容限，可以假定为0。例如：

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

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

Optionally, numerical answers can be written as a span in the following format {#MinimumValue..MaximumValue}.

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

Moodle的浏览器界面不支持多项数学题答案，但是Moodle的代码支持，GIFT也支持。这样就可以用来指定数字的多重范围；当与百分比权重结合时，特别有用。如果使用多个答案，这些答案必须用等号分开，就像简答题一样。例如：

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

注意：因为Moodle浏览器GUI不支持数学问题的多项答案，通过Moodle就不能看到和编辑多项答案。改变原来的数字答案的唯一方法是删除或重新导入这个问题（或者选择其它语言，像phpMyAdmin）。

选择

除了这些基本的问题类型，此过滤器还提供了如下选择：整行注释、问题名称、反馈和百分比权重。

整行注释：

注释不能被导入到Moodle中，但可以包含在文本文件中。注释可以用于提供标题或关于问题的更多信息。以双反斜线开始的所有行都会被过滤器忽略。例如：

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

问题名称：

您可以把一个问题名称放在双冒号之间并置于开头。例如：

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

如果没有指定问题名称，那么缺省情况下整个问题就是名称。

反馈：通过在答案后加一个数学符号（#）和反馈，可以把反馈放在每个答案中。

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

对于单选题，反馈只在学生选择答案后显示。对于简答题，反馈只在学生输入相应的正确答案时显示。对于是非题，导入的反馈被保存起来，当学生选择错误答案时，显示该反馈。因此，在上述例子中，学生只有选择TRUE时，才能看到反馈。

答案的百分比权重：

答案的百分比权重既可以用于单选题，也可以用于简答题。答案的百分比权重在波浪号（单选题）或等号（简答题）后，把期望的百分数填在两个百分号内（例如：%50%）。选项可以与反馈结合在一起。例如：

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

注意：最后两个例子在本质上是一样的，第一个作为单选题，然后作为简答题。

注意：通过浏览器界面指定答案百分比权重的方法，可能不起作用。导入页面的分数匹配下拉列表，可以决定答案的百分比权重是怎样起作用的。

您既可以要求报告错误答案，也可以要求把答案权重调为最有效的答案权重。

给问题指定文本格式

问题文本只允许有一个可选择的文本格式。目前，可以用的格式有moodle（Moodle自动套用格式），html（HTML格式），plain（Plain文本格式）以及markdown(Markdown 格式)。格式在问题文本前的方括号内指定。 在Moodle中关于文本格式的更多信息。

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

多选题：
多个答案选项用于多选题，为了得到满分，学生必须选择两个或两个以上的答案。通过把部分答案权重赋值于多个答案，激活多个答案选项。这时，只选择一个正确答案不能得到满分。例如：

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

注意：任何答案都没有等号（=）,答案的权重百分比总和不能超过100%。否则，Moodle会返回一个错误提示。为了避免学生通过简单的核算答案而得到满分，最好把错误答案设置为负权重。

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

特殊字符 ~ = # { }:

这些符号~ = # { }控制过滤器的操作，在问题中不能用作一般的文本。因为这些符号有专门的作用：决定过滤器的操作，所以被称作“控制符”。但是，有时您可能要用这些符号中的一个，例如：在一个问题中用到一个数学公式。处理这个问题的方法是“避开”这些控制符。您只需在控制符前加一个反斜线(\)，这样，过滤器就知道了：您想用它作为文字字符，而不是控制符。例如：

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

当运行这个问题时，反斜线就被忽略了，也不会被保存在Moodle 中。

其它的选择:

简答题可以通过在下一行中把“0”变为“1”来区分大小写：
$question->usecase = 0; // Ignore case

上海师范大学 教育技术系 06级研究生 张志梅译 zzmei84@gmail.com
上海师范大学 教育技术系 06级研究生 郑起运 李岩 夏丽君 刘启刚校