"GIFT" フォーマットのインポート

GIFTはMoodleのテスト・クイズ問題をテキストからインポートするフォーマットとして、 幅広く利用できるものです。GIFTにおいては多肢選択問題、○×問題、 記述問題、組み合わせ問題や数値問題を利用することができます。また各問題の中で、 穴埋め式のフォーマットを利用することができます。1つのテキストファイルの中で、 複数の問題形式を用いることもできます。さらにこのフォーマットにおいては 問題に関するコメント・メモや各問題のタイトルを加えたり、解答に対するフィードバックを行ったり、 解答に対して部分得点（%）を設定することもできます。

テキストファイルを作成するときのエンコーディングは各自のMoodleで使用しているもの と同じである必要があります。テスト・クイズのテキストファイルの例は gift/examples.txt で見ることができます。

問題形式

多肢選択問題（と一般の説明）：
多肢選択問題を作成するときは解答部分（{ }で囲まれている部分）に選択肢となる項目を記し、 それらの選択肢中の誤っている項目の前に(~)を、正しい項目の前に(=)を付けます。

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

作成する問題の中で穴埋め式を用いる時は文章中の空欄の部分（解答部分）に自動的に下線が引かれます（このような_____下線です）。 穴埋め式を使用するためには解答が埋め込まれる部分（下線を引きたい部分）に解答部分を設定し、答えを記入して下さい。

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

文章の中に解答を挿入するような形の問題の場合にはこの穴埋め式を用いて下線を作成することができます。 どの問題形式で問題を作成するでも、穴埋め式を用いることができます。

問題項目と問題項目の間は一行空ける必要があります（２回改行を押す）。 各問題項目の選択肢にはそれぞれ一行ずつ用い、またそれらをインデントして表示をすると、 整ったフォーマットになります。下の例を見て下さい。

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

記述問題への解答として、正解が1つしかない場合は (=)記号を付けずにそのまま答えを書くこともできますが、 ○×問題と混乱しないように気をつける必要があります。

○×問題：:
この問題形式では問題として記されている文章が正しいか誤っているかを選択するものです。 問題を作成するときは各文章の最後に{TRUE} {FALSE}、もしくは短縮して{T} {F}を記します。

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

     The sun rises in the east.{T}

組み合わせ式問題：
2つの項目を組み合わせるために、まず(=)で始め、それぞれの項目を -> の記号で分けます。 1つの問題の解答として、少なくとも3つの組み合わせができるようにする必要があります。

     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

         }

M組み合わせ問題では解答へのフィードバックや部分得点の設定のオプションはありません。

数値式問題：
解答が数値である問題作成の場合は解答部分の先頭に # を記入します。 これらの数値式問題には正しい解答として認められる誤差の範囲を設定することができます。 その場合、正しい答えの後にコロン(：)を記入して設定します。 例えば、1.5から2.5までの範囲が正解として認められるのであれば、{#2:0.5}と記します。 これは２からそれぞれ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}.

また、数値式問題の解答は{#最小値..最大値} と範囲を設定して書くこともできます。

     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のブラウザが数値式問題の複数の解答をサポートしていないので、 これらをMoodleを通して見たり編集したりすることができない点です。 複数の数値の解答のある問題を変更する唯一の方法は 問題を削除してから再度インポートする（もしくはphpMyAdmin等を利用する）ことです。

作文問題：
作文問題は空白の回等フィールドを持つ簡単な問題です。 解答部分（{ }で囲まれている部分）内への値の設定は許可されていません。

    Write a short biography of Ulysses S. Grant {}

説明：
説明「問題」に解答部分はありません。

    The next set of questions will concern arithmatic

OPTIONS オプション

GIFTのフィルタではこれまで説明してきた基本的な問題形式に加え、 コメント・メモを加える、問題のタイトルを設定する、解答へのフィードバックを設定する、 部分得点を設定する等のオプションを利用することもできます。

コメント・メモを加える：
GIFTのフィルタでは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.}

多肢選択問題では生徒が選択した選択肢へのフィードバックのみが表示されます。 記述問題では生徒が正しい答えを記入した時のみフィードバックが表示されます。 正誤選択問題では生徒が間違った時にフィードバックが表示されます。 従って、上記の最後の例では生徒・学生が「正しい」と答えた時にフィードバックが表示されることになります。

部分得点を設定する
部分得点は多肢選択問題と記述問題において利用することができ、 正解（100%）に対して何%の得点を割り当てるかを設定することで部分得点をできます。 多肢選択問題においては[~]記号の後、記述問題においては[=]の後に、 ％記号で希望する割合の数字を囲んで設定します（例：%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.}

上記の最後の2つの例は基本的に同じ問題ですが、1つ目は多肢選択問題であり、2つ目は記述問題になっています。

ブラウザからは見ることができない形で、部分得点の設定をすることが可能です。 そのような場合はインポートした時に設定されている数値によって得点が計算されますが、 テストを受けている生徒・学生には普通にしか見えません。 しかし、そのような形で部分得点を設定した場合、教師がMoodleによって問題の編集などを行う時に正しく表示されません。 プルダウンメニューは特定の値しか表示しないため、それらの値に部分得点の設定が一致していない場合は正しく表示されません。 ブラウザのインターフェイスを使って問題の編集をする場合、部分得点の設定はブラウザに表示されているものに変更されます。

複数解答：
複数解答のオプションは多肢選択問題において、2つ以上の選択肢を選択することで正解とする場合に用いられます。 複数解答のオプションを利用するためにはそれぞれの答えに部分得点を設定します。 そうすることで、1つの項目を選択しただけでは正解としての得点を得られなくなります。

     What two people are entombed in Grant's tomb? {

          ~No one

          ~%50%Grant

          ~%50%Grant's wife

          ~Grant's father }

上の例の場合に、(=)がどの項目にも用いられていない点と全項目の得点の合計が100%以下になっている点に注意して下さい。 そうではない場合はMoodleはエラーとして扱います。生徒・学生が、全項目選ぶことで100%を得ることがないように、 誤っている解答の項目にはマイナスを付けて-50%を設定しておくと良いでしょう。

     What two people are entombed in Grant's tomb? {

          ~%-50%No one

          ~%50%Grant

          ~%50%Grant's wife

          ~%-50%Grant's father }

特別な記号 ~ = { } ：
GIFTのフィルタはこの( ~ = { } )特別のコントロール記号を使います。 従って、普通の文字として、文章中に用いることができません。 しかし、HTML Entitiesとして書けば、この文字を表示することが可能となります。 HTML Entities（コード）を使用することによって、これらのコントロール記号を直接 入力しなくても、ブラウザで表示させることができます。例えば、=を入力すれば、 ブラウザで見る時にはイコール記号(=)が表示します。問題の例を見て下さい。

    Which answer equals 5? {

          ~= 2 + 2

          == 2 + 3

          ~= 2 + 4  }

これらの答えは = 2 + 2、= 2 + 3、= 2 + 4として表示します。 この方法を利用して、HTMLコードをコードとして表示することも可能となります。 以下のリストはこれらのコントロール記号のHTML Entitiesのコードが記されています。

     記号       コード

       ~        ~

       =        =

       {        {

       }        }

       <        &lt;

       >        &gt;

カテゴリの指定

GIFTファイルで問題が追加されるカテゴリを変更することができます。 カテゴリはファイルの中で好きなだけ変更することができます。 修飾語句の後から次の修飾語句またはファイルの終わりまでのすべての問題は指定されたカテゴリに追加されます。 最初の修飾語句に至るまで、インポート画面で指定されたカテゴリが使用されます。 カテゴリを指定するためにはインポート画面でファイルからインポートする:ボックスをチェックする必要があります。

行にカテゴリ修飾語句を含むには (行の前後に空白を入れて) 下記のように記述してください:

$CATEGORY: tom/dick/harry

またはシンプルに

$CATEGORY: mycategory

... 最初の例は入れ子のカテゴリを指定しています。この場合、問題は harry に追加されます。 指定したカテゴリが存在しない場合、そのカテゴリが作成されます。

その他のオプション：
記述問題において、大文字、小文字の認識をするように設定することができます。その場合、以下のラインの中で、 0 を 1 に変更することで設定できます。
$question->usecase = 0; // Ignore case

その他のオプションはgift/format.phpのインポートフィルタの編集において入手することができます。

CREDITS

このGIFTのフィルタはMoodleコミュニティの多くの方々の力を合わせて書かれたものです。 始めは穴埋め式フォーマットに基づいたものであり、これはMartin DougiamasやThomas Robb、その他にも 多くの人々によって作成されたコードを用いたものです。Paul Tsuchido Shewは2003年12月に、 コミュニティからのアドバイスなどを統合し、さらに幅広いフォーマットとして、 このフィルタを作成しました。この「GIFT」という名前は「General Import Format Technology」の 頭文字をとり名付けられたと思われますが、このようにシンプルなフィルタには短く「GIFT」で良いと思います。

GIFTドキュメンテーションの著者：Paul Tsuchido Shew http://ac.shew.jp. 日本語訳も同著者。
この翻訳の最新編集：2007.07.23.