GIFTフォーマット

ギフトからのリダイレクト)

GIFTフォーマットを使用すると、テキストエディタを使用して、欠けている単語や数値の質問と一致する、多肢選択、○/×問題、記述問題をインポート可能な簡単なフォーマットで書くことができます。 GIFT形式もQuestion bankで利用可能なエクスポートファイル形式です。このフォーマットはMoodleコミュニティ内で開発されていますが、他のソフトウェアがそれをサポートしている場合があります。

  • 多数の質問を作成する場合、GIFTは質問を質問カテゴリまたはレッスンに一括ロードするための簡単な方法を提供します
  • GIFTファイルで質問を表示すると、質問カテゴリの質問を簡単に校正できることがあります。

一般的な手順

各質問の間に少なくとも1行の空白行を残す必要があります。

単純な形式では、質問が最初に来て、次に正解(=)を示す等号(=)と間違った答えをチルド(〜)することで、答えが大括弧で囲まれます。ハッシュ(#)は応答を挿入します。質問には、重みの周囲にパーセント記号(%..%)を付けることで重みを付けることができます。コメントの前には二重スラッシュ(//)が付き、インポートされません。

これは、インポートしたり、大まかなテンプレートとして使用したりすることができる便利なギフトの例です。以下の例の多くは、ファイル内の質問を出発点として使用しています。

UTF-8エンコーディング

GIFTファイルすべてUTF-8で正しくエンコードされている必要あります。あなたはあなたのファイルをUTF-8で保存するためにWindowsに付属のMicrosoftのテキストエディタNotepadを使うことができます。

:ANSIフォーマットは、(ä、ö、ü、æ、å、ø、œ、ßなどの)特殊文字のない言語に対して(のみ)機能します。そしてこれは実際にはUTF-16であり、動作しないのでフォーマットとして "Unicode"を使用しないでください。詳しくは、 ファイルのUTF-8への変換を参照してください。

フォーマット記号

これが一般的なギフトシンボルとその使用法です。

シンボルつかいます
//テキスト行末までのコメント(オプション)
::タイトル:: 質問のタイトル(オプション)
テキスト質問テキスト(タイトルが指定されていない場合はタイトルになります)
[...フォーマット...] 次のテキストのフォーマット。オプションは[html]、[moodle]、[plain]、[markdown]です。質問テキストのデフォルトは[moodle]です。質問のその他の部分は質問テキストに使用されるフォーマットにデフォルト設定されます。
{ 回答を開始 - 回答がない場合、テキストは以下の質問の説明です
{T}または{F} 真または偽の答え。 {TRUE}および{FALSE}も
{... =正しい...} 多肢選択問題に対する正しい答え、(複数回答? - ページのコメントを参照)または空白を記入
{...〜間違っています...} 複数選択または複数回答に対する誤った答え
{... = item - > match ...} 一致する質問に対する回答
#フィードバックテキスト先行する複数の回答、空欄埋め、または数値回答に対する回答の回答
####一般的なフィードバック一般的なフィードバック
{# 数値回答を開始
答え:寛容許容範囲内の数値で回答可能
低い。 受け入れられた数値回答の下限値と上限値
=%n%回答:許容範囲回答からの許容範囲内で複数の数値範囲の1つに対するnパーセントのクレジット
} 回答を終了
\キャラクターバックスラッシュは、〜、=、#、{、}、および:の特別な意味をエスケープします。
\ n 質問テキストに改行を入れる - 質問を区切る空白行

ここにいくつかの簡単な例があります:

 // ○/×問題
:: Q1 :: 1 + 1 = 2 {T}

//正解と不正解に対する指定のフィードバックを含む複数選択
:: Q2 ::スペクトルのオレンジとグリーンの違いは何ですか? 
{=黄色#正しい;良い! 〜赤#間違っている、それは黄色です〜青#間違っている、それは黄色です}

// 空欄を埋める
:: Q3 :: Two + {= two = 2}は4です。

//組み合わせ問題
:: Q4 ::どの動物がどの食べ物を食べますか? {=猫 - >猫の食べ物=犬 - >犬の食べ物}

//数学範囲の質問
:: Q5 :: 1から5までの数字は何ですか? {#3:2}

//区間終了点で指定された演算範囲
:: Q6 :: 1から5までの数字は何ですか? {#1..5}
//インポート時にQ5と同じに翻訳されましたが、Moodle質問インターフェースからは利用できません

//部分的なクレジットとフィードバックを含む複数の数値回答
:: Q7 ::ユリシーズS.グラントはいつ生まれたのですか? {#
         = 1822:0#正しい!フルクレジット
         =%50%1822:2#彼は1822年に生まれました。
}

//作文問題
:: Q8 ::お元気ですか? {}

フォーマット記号の説明

質問に対するコメント行としての//以下の複数選択形式。Moodleがそれをエクスポートすると、ここに質問の一意のID番号が表示されます。

::の最初のセットは質問のタイトルの前にあります。

2番目の::は実際の質問の前にあります。最初の{は回答の始まりを示します。正解は=記号で、間違った答えは〜で始まります。教師の回答の前に#が付いています。質問は}で終わり、その後に空白行が続きます。注括弧ではない{}です。通常、これらは[AltGr]キーを使って取得されます。

 //コメント行 
::質問のタイトル 
:: 質問 {
=正解
〜間違った答え1
#間違ったanswer1に対する回答
〜間違った答え2
#間違ったanswer2への回答
〜間違った答え3
#間違った回答への回答3
〜間違った答え4
#間違ったanswer4への回答
}

多肢選択問題のための最短フォーマットは次のとおりです。

質問{=正しい答え〜間違った答え1〜間違った答え2〜間違った答え3〜間違った答え4}
ヒント:質問のタイトルを指定しなかった場合、Moodleへのインポート時にWHOLE質問がタイトルとして使用されます。これを可能にすることには長所と短所があります。
    • 短所:これは不要な単語をたくさん追加する可能性があります。これには、エクスポートGIFTプロセスを混乱させる可能性のある文字が含まれる可能性があります。
    • 長所:その一方で。各質問の開始が異なる場合は、質問のカテゴリリストで単一の質問を見つけるのが簡単になります。それはあなたがタイプする手間を省きます。すべての質問に同じタイトルを付けることは非常に悪い考えです。

質問フォーマットの例

GIFTフォーマットを書くためにテキストエディタを使用するいくつかの方法があります。私たちは、例えば単純なバージョンを表示しようとします、そして、いくつかのフォーマットで、私たちは多くのMoodle Questionフォーマットにインポートすることができるいくつかのより複雑な機能を紹介します。

多肢選択問題

多肢選択式の質問では、間違った答えの前にチルダ(〜)が付き、正しい答えの前に等号(=)が付きます。

これは、単純で受け入れ可能なGIFT複数選択形式です。

誰がグラントの墓に埋葬したのですか?{=グラント〜誰も〜ナポレオン〜チャーチル〜マザーテレサ}

これは、GIFT要素のほとんどを使用する長い形式です。

 //質問:1名:墓を付与
:: Grantsの墓::誰がニューヨークのGrantの墓に埋葬されていますか? {
=助成金
〜誰もいない
#12年間は正しいが、グラントの遺跡は1897年に墓に埋葬された
〜ナポレオン
#フランスに埋葬された
〜チャーチル
#イギリスに埋葬された
〜マザーテレサ
#インドに埋葬された
}

複数の正しい答えを持つ多肢選択問題

つまり、ラジオボタンではなくチェックボックスを使用します。

グラントの墓に2人の人々が陥っていますか? {
   〜%-100%誰もいません
   50%までの補助金
   〜%50%グラントの妻
   〜%〜100%グラントの父親
}

○/×問題

この質問タイプでは、答えはその声明が真実か偽かを示します。答えは{TRUE}または{FALSE}と書くか、または{T}または{F}と省略します。

 //質問:0名前:{T}スタイルを使ったTrueStatement
:: GrantについてのTrueStatement :: Grantはニューヨークの墓に埋葬されました。{T}

//質問:0名前:{FALSE}スタイルを使用したFalseStatement
::太陽についての偽の声明::太陽は西に昇る。{FALSE}

記述問題

記述問題の質問タイプの回答は、すべて等号(=)が前に付いていて、すべて正解であることを示しています。答えはチルダを含んではいけません。

これは、クレジットに対する正しい答えを示す簡単な方法を使用した2つの例です。

誰がグラントの墓に埋めたのですか?{=グラント=ユリシーズS.グラント=ユリシーズ・グラント}
 2と2は等しい{= four = 4}

正解が1つしかない場合は、True-Falseと混同しない限り、等号の接頭辞を付けずに書くことができます。

組み合わせ問題

一致するペアは等号(=)で始まり、このシンボル " - >"で区切られています。少なくとも3つの組み合わせ問題ペアが必要です。

次の国をそれぞれ対応する首都と一致させてください。 {
   =カナダ - >オタワ
   =イタリア - >ローマ
   =日本 - >東京
   =インド - >ニューデリー
   }

組み合わせ問題質問は、フィードバックまたは回答率の割合をサポートしません。

行方不明の言葉

Missing Wordフォーマットは自動的に文中に空欄の一行(_____のような)を挿入します。 Missing Word形式を使用するには、文中の行を表示する場所に回答を配置します。

 moodleはmoodle.orgからダウンロードするために{〜たくさんのお金=なにもしない〜少額}を要します。

答えが句読点の前にくると、 "missing word"フォーマットのために空白を埋める行が挿入されます。すべての質問タイプは、Missing Wordフォーマットで書くことができます。

質問を区切る空白行(二重キャリッジリターン)が必要です。明確にするために、答えは別々の行に書いても字下げすることができます。いくつかの例:

 Mahatma Gandhiの誕生日は、次の日にインドでの休日です。{
〜15日
〜3日
= 2番目
10月の}。

以来{
  〜495 AD
  = 1066 AD
  〜1215 AD
  〜43 AD
}
ヘイスティングスイングランドの町は「観光客で有名」です。

数値の質問

数値質問の回答セクションは、番号記号(#)で始める必要があります。数値回答には、正しい回答の後にコロンで区切って書かれたエラーマージンを含めることができます。そのため、例えば、正解が1.5から2.5の間であれば、それは次のように書かれるでしょう{#2:0.5}。これは、エラーマージンが0.5の2が正しいことを示します(つまり、1.5から2.5の範囲)。エラーマージンが指定されていない場合は、ゼロと見なされます。

これは簡単な数値形式の質問です。それは5年の範囲を受け入れます。

 Ulysses S. Grantはいつ生まれたのですか?{#1822:5}

範囲のマージンを確認することをお勧めします。3.141は正しいとは見なされず、3.142は範囲内と見なされます。

 piの値は何ですか(小数点以下第3位まで)? {#3.14159:0.0005}。

必要に応じて、数値回答をスパンとして次の形式で記述することができます。{#MinimumValue..MaximumValue}.

 piの値は何ですか(小数点以下第3位まで)? {#3.141..3.142}。

Moodleのブラウザインターフェースは複数の数値回答をサポートしていませんが、MoodleのコードはGIFTをサポートしています。これは、数値の複数スパンを指定するために使用できます。また、パーセンテージ重量評定と組み合わせると特に便利です。複数の回答を使用する場合は、短い回答の質問のように、それらを等号で区切る必要があります。

ユリシーズS.グラントはいつ生まれたのですか? {#
   = 1822:0
   =%50%1822:2
}

MoodleのブラウザGUIは数値的な質問に対する複数の回答をサポートしていないため、古いMoodleバージョンではそれらを見たりMoodleを通して編集したりすることはできません。最初の回答以外に数値回答を変更する唯一の方法は、質問を削除して再インポートすることです(またはphpMyAdminのようなものを使用します)。しかし、もっと良いのはあなたのMoodleを少なくとも1.9にアップグレードすることです。

作文問題

作文問題は、空の回答フィールドを持つ単純な質問です。中括弧の間には何も許されません。

 DagHammarskjöldの短い略歴を書く。 {}

説明

説明には回答部分がまったくありません

あなたはこれらの次の数学の質問にあなたの鉛筆と紙を使うことができます。

オプション

これらの基本的な質問タイプに加えて、このフィルタは以下のオプションを提供します:行コメント、質問名、フィードバックおよびパーセント回答ウエイト。

行コメント

Moodleにインポートされないコメントはテキストファイルに含めることができます。これはヘッダや質問に関するより多くの情報を提供するために使うことができます。二重のバックスラッシュで始まる行(タブやスペースは含まない)はすべてフィルタによって無視されます。

 //小見出し:下記の数値的な質問
2プラス2は何ですか? {#4}

コメントはMoodleからエクスポートされ、固有の質問IDが含まれます。 Moodleからインポートしてエクスポートした後の上記の質問:

 //質問:914名前:2プラス2とは何ですか? 
:: 2 2 + 2は何ですか:: 2 2 + 2は何ですか?{#
    = 4:0#
}

質問名

質問名は、最初に配置して二重コロン(:: ...::)で囲むことで指定できます。

 ::漢字の由来::もともと日本語の文字
どの国から来たの? {=中国}
 ::感謝祭の日::感謝祭のアメリカの祝日は 
11月の{〜second〜third = fourth}木曜日に祝われました。

質問名を指定しないと、デフォルトで質問全体が名前として使用されます。

フィードバック

番号記号(#はハッシュマークとも呼ばれます)とフィードバックを使用して回答をたどることで、回答ごとにフィードバックを含めることができます。

この多肢選択問題に対する答えは何ですか? {
  〜間違った答え#間違った答えに対する意見コメント
  〜別の間違った回答#この間違った回答についてのフィードバックコメント
  =正しい答え#とてもいいね!
}
 
//ヒッチハイカーガイドから銀河へ
深い思考は言った」
  = 42#ヒッチハイクの銀河ガイドに従ってください。
  = 42#正しい、LoonquawlとPhouchgに言われるように
  = 42#正しい!
人生、宇宙、そしてすべてのものについての究極の質問に対する究極の答えです。」

   42はすべてに対する絶対的な答えです。
FALSE#42が究極の答えです。#あなたは正しい答えを出しました。

多肢選択問題の場合、フィードバックは学生が選択した解答に対してのみ表示されます。記述問題の場合、学生が対応する正解を入力したときにのみフィードバックが表示されます。○/×問題の質問では、1つまたは2つのフィードバック文字列があります。最初の質問は、学生が間違った答えを出した場合に表示されます。学生が正しい答えを出したら2番目。

割合回答ウェイト

パーセンテージ回答ウェイトは、多肢選択問題と記述問題の両方に使用できます。パーセント回答の重みは、パーセント記号で囲まれた希望のパーセント(例:%50%)を使用してチルダ(多肢選択の場合)または等号(記述問題の場合)をたどることで含めることができます。このオプションはフィードバックコメントと組み合わせることができます。

難しい質問です。{~間違った答え ~%50%半分のクレジット返答=完全なクレジット返答}

 ::イエスの故郷::イエス・キリストは
   〜エルサレム#これは重要な都市でしたが、答えは間違っていました。
   〜%25%ベツレヘム#彼はここで生まれたが、ここでは育っていない。
   〜%50%ガリラヤ#あなたはより具体的である必要があります。
   =ナザレ#うん!そのとおり!
}。
    
::イエスの故郷::イエス・キリストは
   =ナザレ#うん!そのとおり!
   =%75%Nazereth#正しい、しかしスペルミス。
   =%25%ベツレヘム#彼はここで生まれたが、ここでは育っていない。
}

最後の2つの例は基本的に同じ質問です。最初は多肢選択問題として、次に記述問題としてです。

ブラウザインタフェースでは利用できないパーセンテージ回答の重みを指定することが可能です。インポートページの[Match Grades]ドロップダウンは、これらの処理方法を決定します。エラーを報告するか、回答の重みを最も近い有効な回答の重みに調整するように要求できます。

具体的には、Moodleはその計算に小数点以下5桁を使用するため、パーセンテージを3で割る場合は、%33または%33.33ではなく%33.33333を使用してください。

質問のテキストフォーマットの指定質問テキスト(のみ)には、オプションのテキストフォーマットを指定できます。現在利用可能なフォーマットは、moodle(Moodle自動フォーマット)、html(HTMLフォーマット)、プレーン(プレーンテキストフォーマット)、およびマークダウン(Markdownフォーマット)です。形式は、質問テキストの直前に角括弧で囲まれて指定されています。詳しくは、 テキストのフォーマットを参照してください。

 [マークダウン] *アメリカの感謝祭*の祝日は、
   〜2番目
   〜3番目
   = 4番目
11月の木曜日

複数回答

複数回答オプションは、完全なクレジットを取得するために2つ以上の回答を選択する必要がある場合に、多肢選択問題に使用されます。複数回答オプションは、単一の回答が完全なクレジットを受け取らないようにしながら、複数の回答に部分的な回答の重みを割り当てることで有効になります。

グラントの墓に2人の人々が陥っていますか? {
   〜誰もいない
   50%までの補助金
   〜%50%グラントの妻
   〜グラントの父親
}

どの回答にも等号(=)は含まれておらず、回答は合計で100%を超えないようにしてください。そうしないと、Moodleはエラーを返します。すべての答えをチェックするだけで自動的に100%が得られるという問題を回避するには、間違った答えに対して負の答えの重みを含めることをお勧めします。

グラントの墓に2人の人々が陥っていますか? {
   〜%-50%
   50%までの補助金
   〜%50%グラントの妻
   〜%〜50%グラントのお父さん
}

特殊文字~=#{}

これらの記号~=#{}:このフィルタの動作を制御します。質問内で通常のテキストとして使用することはできません。これらの記号は、このフィルタの動作を決定する上で特別なロールを果たしているので、「制御文字」と呼ばれます。しかし、質問の中に数式を表示するなどの目的で、これらの文字の1つを使用したい場合があります。この問題を回避する方法は、制御文字を「回避する」ことです。つまり、制御文字の前に円記号(¥)を付けるだけで、制御文字としてではなくリテラル文字として使用したいことがフィルターに認識されます。例えば:

 5と等しい答えはどれですか。 {
   〜\ = 2 + 2
   = \ = 2 + 3
   〜\ = 2 + 4
}
 ::ギフト制御文字::
次のうちどれがGIFTのインポート形式の制御文字ではありませんか? {
  〜\〜#\〜は制御文字です。
  〜\ =#\ =は制御文字です。
  〜\##\#は制御文字です。
  〜\ {#\ {は制御文字です。
  〜\}#\}は制御文字です。
  = \#正しい! \(バックスラッシュ)は制御文字ではありません。しかし、
             制御文字をエスケープするために使用されます。
}

質問が処理されると、バックスラッシュは削除されMoodleには保存されません。

回答に含まれるHTML

質問の前に[html]を追加すると、GIFT形式はHTMLを正しく解釈します。 このフォーラムのスレッドをてください

カテゴリを指定する

GIFTファイル内で質問を追加するカテゴリを変更することができます。ファイル内では、カテゴリは何度でも変更できます。修飾子の後から次の修飾子またはファイルの最後までのすべての質問が、指定されたカテゴリに追加されます。最初のカテゴリー修飾子までは、インポート画面で指定されたカテゴリーが使用されます。これが機能するためには、インポート画面でfrom file:ボックスがチェックされている必要があります。

カテゴリ修飾子を含めるには、次のような行を含めます(前後に空白行があります)。

 $ CATEGORY:トム/ディック/ハリー

あるいは単に

 $ CATEGORY:mycategory

...最初の例では、ネストしたカテゴリのパスを指定しています。この場合、質問は急ぎます。カテゴリが存在しない場合は、カテゴリが作成されます。

カテゴリがどのように編成されているかを調べるには、まずカテゴリデータを含むいくつかの質問をエクスポートしてから、エクスポートされたGIFT形式のファイルを確認します。最低レベルのシステムコンテキストでは、$ CATEGORY:$ system $ / ....のようになります。

質問の大文字と小文字を区別する

Moodle / question / format / gift / format.phpファイルの次の行 「0」を「1」に変更することで、記述問題の質問で大文字と小文字を区別することができます

 $ question-> usecase = 0; //大文字と小文字を区別しない

ヒントとコツ

  • Moodleがリストを提示したり別のGIFTファイルとしてそれらをエクスポートするときあなたの質問をまとめるためにすべての質問の始めに:: title ::を使用してください。タイトルが空白のままの場合、Moodleは質問の先頭をタイトルとして配置します。何人かの教師はタイトルに "001 LIT101 Poe ref Purloin Letter"や "The Purloin Letterは(AmLit pg 254)によって書かれました"のようなものを見たがっています。
  • 質問テキストの直前に[html]、[moodle]、[plain]、または[markdown]を設定して質問をフォーマットする必要がある場合は、マークアップを指定できます。これについては、下記のpdfを参照してください。
  • レッスンモジュールの質問ページでは、正解はデフォルトで次のページにジャンプし、不正解はこのページにジャンプします(つまり、学生は「再試行」する必要があります)。 GIFTフォーマットファイルからインポートするとき、これはまさに使われるメカニズムです。
  • 答えが正しいか間違っているかに関係なく、ある質問から次の質問に直接連れて行かれるようにするには、[レッスンの設定]で、[最大試行回数]を1に設定します。
    • ただし、各質問に回答すると、「正しい/正しくありません」というメッセージが学生に表示されます。この(デフォルトの)フィードバックメッセージを表示したくない場合は、独自のフィードバックメッセージを入力してください(例: "continue"、 "---"など)。
    • 目に見えるメッセージを表示したくない場合は、フィードバックとして改行なしのスペースを入力してください。余白が見えるので、Moodleは自動応答をしません。これを行うには、答えの後に#を置き、書くNbsp.png (これらの文字の間にスペースを入れずに)
  • 質問や回答に特殊なGIFT文字を使用する必要がありますか。 GIFT文字の前に\を置きます。
    • たとえば、(TeX式を含む数学の問題で)GIFTファイルで中括弧、{または}、等号、=、#、または〜を使用する場合は、それらの前に\を直接付けてエスケープする必要があります。各{または}または=の前に。 Moodleにインポートする前に置換プログラム/マクロ/エディタフィルタを使用してこの変換を行うことが可能です。
  • T / Fタイプの質問を多肢選択問題に変更したいですか。 T / Fの質問をGIFTファイルとしてエクスポートしてから、テキストエディタを使用して(T)を(= True〜False)に置き換えます。新しい質問がわかるように、タイトルを少し変更してください。
  • 大文字と小文字が区別されるアルファベット比較はデフォルトで無効になっています。短い回答の質問で大文字と小文字を区別する比較が必要な場合(異常な必要性)、それらの前に次のように入力します。
 $ question-> usecase = 1;

空白行で囲まれています。

ギフトを作成または処理するツール

何人かの貢献者は、より身近な人気のあるプログラムからGIFTファイルを生成するためにマクロを使用しました。

試験を書いてGIFT形式に変換するためのOOoテンプレート2013

  • Writerでギフトファイルを生成するためのOpen Officeテンプレートがあります。これらは試験を書いてGIFT形式のスレッドに変換するためのOOoテンプレート内の小テストフォーラムにあります
    • OO 2.xの最新版は、2005年12月17日にEnrique Castroによって投稿された "OOo2GIFT_Template_05.zip"です。
    • 以前のバージョンは、Enrique Castroによって2005年3月22日に投稿された "GIFT_template_OOo.zip"です。
  • a4esl.orgにはオンラインで複数の質問を生成する使いやすいものがあります。ここでは、マークを作成せずに質問を書いて、Moodleを選択して小テスト生成ボタンを押します。これは、Moodleにインポートするためにファイルに貼り付けることができるGIFTフォーマットのテキストを作成します。
    • 初期フォーマットは、GIFTフォーマットよりもキーストロークが少なくてすみ(行位置とリターンを使用)、時間を節約でき、無効なデータを作成する可能性が少なくなります。
    • Microsoft Wordのための小テストオーサリング・テンプレートリンク
    • Moodle XML Converter [1]
    • RubyのGIFTフォーマットパーサライブラリ[2]
  • GIFTをJavaScriptオブジェクトに解析するPEG.js(JavaScript)を使ったGIFT文法[3]
    • 上記のPEG.js文法に基づくオンラインGIFT質問バリデータ(編集者) [4]

メディア付きのGIFTフォーマット(画像、音声など)

mediasオプションプラグインGIFTはGiftと似たインポートフォーマットであり、同じ構文を使用しますが、テキストファイルの代わりにギフトテキストファイルとメディアファイル(画像、サウンドなど)を含むzipファイルをインポートします。 ドキュメンテーションはあなたの質問にメディアを含める方法を説明します。

関連情報

外部リンク