L-electron-Rare/moodle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

MDL-5086 - Improve the formatting of the question import and export help so that the code samples fit.

Browse Source
This commit is contained in:
tjhunt
2007-09-26 20:12:39 +00:00
parent e7c9105d26
commit 231e409849
4 changed files with 162 additions and 122 deletions
Download Patch File Download Diff File Expand all files Collapse all files
lang/en_utf8/help/quiz/export.html
+7 -8
View File
@@ -14,7 +14,7 @@
<p>The format(s) currently supported are:</p>
<h2>GIFT format</h2>
<div class="indent">
<p>GIFT is the most comprehensive import/export format available for exporting
Moodle quiz questions to a text file. It was designed to be an easy
method for teachers writing questions as a text file. It supports Multiple-Choice,
@@ -36,31 +36,30 @@ When was Ulysses S. Grant born?{#1822}
</pre>
<p class="moreinfo"><a href="help.php?file=formatgift.html&amp;module=quiz">More info about the "GIFT" format</a></p>
</div>
<h2>Moodle XML format</h2>
<div class="indent">
<p>This Moodle specific format exports quiz questions in a simple XML format. They
can then be imported into another quiz category or used in some other process such as
an XSLT transformation. The XML format will export images attached to questions (encoded
base64).</p>
</div>
<h2>IMS QTI 2.0</h2>
<div class="indent">
<p>Exports in the standard IMS QTI (version 2.0) format. Note that this generates a group of files within
a single 'zip' file.</p>
<p class="moreinfo"><a href="http://www.imsglobal.org/question/" target="_qti">More information on the IMS QTI site</a>
(external site in new window)</p>
</div>
<h2>XHTML</h2>
<div class="indent">
<p>Exports the category as a single page of 'strict' XHTML. Each question is clearly placed in its own
&lt;div&gt; tag. If you want to use this page as-is, you will need to at least edit the &lt;form&gt; tag at the
start of the &lt;body&gt; section to provide a suitable action (eg, a 'mailto').</p>
</div>
<p>Import and Export formats are a pluggable resource. Other optional formats may be available in the
Modules and Plugins database.</p>
lang/en_utf8/help/quiz/formatgift.html
+134 -90
View File
@@ -21,56 +21,69 @@
<p><u>Multiple Choice:</u><br />
For multiple choice questions, wrong answers are prefixed with a tilde (~)
and the correct answer is prefixed with an equal sign (=).</p>
<pre> Who's buried in Grant's tomb?{~Grant ~Jefferson =no one}</pre>
<pre>
Who's buried in Grant's tomb?{~Grant ~Jefferson =no one}
</pre>
<p>The <b>Missing Word</b> format automatically inserts a fill-in-the-blank line (like this _____) in the middle of the sentence.
To use the Missing Word format, place the answers where you want the line to appear in the sentence.</p>
<pre> Grant is {~buried =entombed ~living} in Grant's tomb.</pre>
<pre>
Grant is {~buried =entombed ~living} in Grant's tomb.
</pre>
<p>If the answers come before the closing punctuation mark, a fill-in-the-blank line will be inserted
for the &quot;missing word&quot; format. All question types can be written in the Missing Word format.</p>
<p>There must be a blank line (double carriage return) separating questions.
For clarity, the answers can be written on separate lines and even indented. For example:</p>
<pre> 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}</pre>
<pre>
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
}
</pre>
<p><u>Short Answer:</u><br />
Answers in Short Answer question-type are all prefixed by an equal sign (=),
indicating that they are all correct answers. The answers must not contain a tilde.</p>
<pre> Who's buried in Grant's tomb?{=no one =nobody}
<pre>
Who's buried in Grant's tomb?{=no one =nobody}
Two plus two equals {=four =4}.</pre>
Two plus two equals {=four =4}.
</pre>
<p>If there is only <u>one</u> correct Short Answer, it may be written without the equal sign prefix,
as long as it cannot be confused as True-False.</p>
<p><u>True-False:</u><br />
In this question-type the answer indicates whether the statement is true or false.
The answer should be written as {TRUE} or {FALSE}, or abbreviated to {T} or {F}.</p>
<pre> Grant is buried in Grant's tomb.{F}
<pre>
Grant is buried in Grant's tomb.{F}
The sun rises in the east.{T}</pre>
The sun rises in the east.{T}
</pre>
<p><u>Matching:</u><br />
Matching pairs begin with an equal sign (=) and are separated by this symbol "->". There must be at least three matching pairs.</p>
<pre> 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
}</pre>
<pre>
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
}
</pre>
<p>Matching questions do not support feedback or percentage answer weights.</p>
<p><u>Numerical:</u><br />
@@ -79,17 +92,24 @@
So for example, if the correct answer is anything between 1.5 and 2.5, then it would be written as follows <u>{#2:0.5}</u>.
This indicates that 2 with an error margin of 0.5 is correct (i.e., the span from 1.5 to 2.5).
If no error margin is specified, it will be assumed to be zero.</p>
<pre> When was Ulysses S. Grant born? {#1822}
<pre>
When was Ulysses S. Grant born? {#1822}
What is the value of pi (to 3 decimal places)? {#3.1415:0.0005}.</pre>
What is the value of pi (to 3 decimal places)? {#3.1415:0.0005}.
</pre>
<p>Optionally, numerical answers can be written as a span in the following format {#<i>MinimumValue</i>..<i>MaximumValue</i>}.</p>
<pre> What is the value of pi (to 3 decimal places)? {#3.141..3.142}.</pre>
<pre>
What is the value of pi (to 3 decimal places)? {#3.141..3.142}.
</pre>
<p>Moodle's browser interface does not support multiple numerical answers, but Moodle's code can and so does GIFT.
This can be used to specify numerical multiple spans, and can be particularly usefully when combined with percentage weight grades.
If multiple answers are used, they must be separated by an equal sign, like short answer questions.</p>
<pre> When was Ulysses S. Grant born? {#
=1822:0
=%50%1822:2}</pre>
<pre>
When was Ulysses S. Grant born? {#
=1822:0
=%50%1822:2
}
</pre>
<p>Note that since Moodle's browser GUI doesn't support multiple answers for Numerical questions,
there's no way to see them or edit them through Moodle.
The only way to change a numerical answer beyond the first, is to delete the question
@@ -98,11 +118,15 @@
<p><u>Essay:</u><br />
An essay question is simply a question with an empty answer field. Nothing is permitted
between the curly braces at all.</p>
<pre> Write a short biography of Ulysses S. Grant {}</pre>
<pre>
Write a short biography of Ulysses S. Grant {}
</pre>
<p><u>Description:</u><br />
A description "question" has no answer part at all</p>
<pre> The next set of questions will concern arithmatic</pre>
<pre>
The next set of questions will concern arithmatic
</pre>
<h3>OPTIONS</h3>
@@ -113,28 +137,35 @@
Comments that will not be imported into Moodle can be included in the text file.
This can be used to provide headers or more information about questions.
All lines that start with a double backslash (not counting tabs or spaces) will be ignored by the filter.</p>
<pre> // Subheading: Numerical questions below
What's 2 plus 2? {#4}</pre>
<pre>
// Subheading: Numerical questions below
What's 2 plus 2? {#4}
</pre>
<p><u>Question Name:</u><br />
A question name can be specified by placing it first and enclosing it within double colons.</p>
<pre> ::Kanji Origins::Japanese characters originally
came from what country? {=China}
<pre>
::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.</pre>
::Thanksgiving Date::The American holiday of Thanksgiving is
celebrated on the {~second ~third =fourth} Thursday of November.
</pre>
<p>If no question name is specified, the entire question will be used as the name by default.</p>
<p><u>Feedback:</u><br />
Feedback can be included for each answer by following the answer with a number sign (# also known as a hash mark) and the feedback.</p>
<pre> 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!}
<pre>
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!}
Who's buried in Grant's tomb? {
=no one#excellent answer!
=nobody#excellent answer!
}
Grant is buried in Grant's tomb.{FALSE#Wrong, No one is buried in Grant's tomb.#Right, well done.}</pre>
<p>For Multiple Choice questions, feedback is displayed only for the answer the student selected.
@@ -147,18 +178,21 @@
Percentage answer weights can be included by following the tilde (for Multiple Choice) or
equal sign (for Short Answer) with the desired percent enclosed within percent signs (e.g., %50%).
This option can be combined with feedback comments.</p>
<pre> 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!}.
<pre>
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.}</pre>
::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.
}</pre>
<p>Note that the last two examples are essentially the same question, first as multiple choice and then as short answer.</p>
<p><font size="-1">Note that it is possible to specify percentage answer weights that are NOT
@@ -172,31 +206,39 @@
<b>markdown</b> (Markdown format). The format is specified in square brackets immediately before the
question text. <a href="help.php?file=textformat.html">More information on text formats in Moodle.</a></p>
<pre>[markdown]The *American holiday of Thanksgiving* is celebrated on the {
~second
~third
=fourth
} Thursday of November. </pre>
<pre>
[markdown]The *American holiday of Thanksgiving* is celebrated on the {
~second
~third
=fourth
} Thursday of November.
</pre>
<p><u>Multiple Answers:</u><br />
The Multiple Answers option is used for multiple choice questions when two or more answers must
be selected in order to obtain full credit. The multiple answers option is enabled by assigning
partial answer weight to multiple answers, while allowing no single answer to receive full credit.</p>
<pre> What two people are entombed in Grant's tomb? {
~No one
~%50%Grant
~%50%Grant's wife
~Grant's father }</pre>
<pre>
What two people are entombed in Grant's tomb? {
~No one
~%50%Grant
~%50%Grant's wife
~Grant's father
}
</pre>
<p>Note that there is no equal sign (=) in any answer and the answers should total no more than 100%,
otherwise Moodle will return an error.
To avoid the problem of students automatically getting 100% by simply checking all of the answers,
it is best to include negative answer weights for wrong answers.</p>
<pre> What two people are entombed in Grant's tomb? {
~%-50%No one
~%50%Grant
~%50%Grant's wife
~%-50%Grant's father }</pre>
<pre>
What two people are entombed in Grant's tomb? {
~%-50%No one
~%50%Grant
~%50%Grant's wife
~%-50%Grant's father
}
</pre>
<p><u>Special Characters ~ = # { } :</u><br />
These symbols <b> ~ = # { } : </b> control the operation of this filter and cannot be used as normal text within questions.
@@ -206,21 +248,23 @@
This means simply putting a backslash (\) before a control character so the filter will know that you want to use
it as a literal character instead of as a control character.
For example:</p>
<pre> Which answer equals 5? {
~ \= 2 + 2
= \= 2 + 3
~ \= 2 + 4 }
<pre>
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.
}</pre>
::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.
}</pre>
<p>When the question is processed, the backslash is removed and is not saved in Moodle.</p>
<h3>Specifying Categories</h3>
lang/en_utf8/help/quiz/formatxml.html
+1
View File
@@ -1,6 +1,7 @@
<h1>Importing "Moodle XML" format files</h1>
<h3>Category Switching</h3>
<p>You can insert a special dummy question into the XML file to specify
the category path into which the following questions will be inserted.
If the category or categories do not exist they will be created. Note that
lang/en_utf8/help/quiz/import.html
+20 -24
View File
@@ -17,8 +17,9 @@
<p>A number of file formats are supported:</p>
<h2>GIFT format</h2>
<div class="indent">
<p>GIFT is the most comprehensive import format available for importing
Moodle quiz questions from a text file. It was designed to be an easy
method for teachers writing questions as a text file. It supports Multiple-Choice,
@@ -39,26 +40,26 @@ When was Ulysses S. Grant born?{#1822}
</pre>
<p class="moreinfo"><a href="help.php?file=formatgift.html&amp;module=quiz">More info about the "GIFT" format</a></p>
</div>
<h2>Aiken Format</h2>
<div class="indent">
<p>This is a simple format for importing multiple choice questions from a text file.</p>
<p class="moreinfo"><a href="help.php?file=formataiken.html&amp;module=quiz">More info about the "Aiken" format</a></p>
</div>
<h2>Moodle XML format</h2>
<div class="indent">
<p>This Moodle specific format imports quiz questions that have previously been
exported in the same format. The format is straightforward and is best demonstrated
by exporting a category in the Moodle XML format. The XML format is capabable of
importing image files.
</p>
<p class="moreinfo"><a href="help.php?file=formatxml.html&amp;module=quiz">More info about the "Moodle XML" format</a></p>
</div>
<h2>Missing Word</h2>
<div class="indent">
<p>This format only supports multiple choice questions and
short answer question, depending on the number of answers. One
answer generates a short answer question, two or more answers
@@ -80,37 +81,35 @@ we become students of {=anatomy and physiology ~reflexology
</p></blockquote>
<p class="moreinfo"><a href="help.php?file=formatmissingword.html&amp;module=quiz">More info about the "Missing Word" format</a></p>
</div>
<h2>Blackboard</h2>
<div class="indent">
<p>This module can import questions saved in Blackboard's "POOL" type export
format. It relies on XML functions being compiled into your PHP.
Note that you must first unpack the exported zip file and provide Moodle
with the appropriate .dat file.
Note that this version <strong>does not</strong> work with Blackboard
Version 6 and newer.</p>
</div>
<h2>Blackboard V6+</h2>
<div class="indent">
<p>This module can import questions saved in Blackboard's export
format. It provides limited support for Blackboard Version 6 and
7. It relies on XML functions being compiled into your PHP. You
must upload the zip file exported from Blackboard.</p>
</div>
<h2>WebCT</h2>
<div class="indent">
<p>This module can import questions saved in WebCT's text-based format.</p>
<p class="moreinfo"><a href="help.php?file=formatwebct.html&amp;module=quiz">More info about the "WebCT" format</a></p>
</div>
<h2>Course Test Manager</h2>
<div class="indent">
<p>This module can import questions saved in a Course Test Manager test bank.
It relies on different ways of accessing the test bank, which is in a Microsoft Access
database, depending on whether Moodle is running on a Windows or Linux web server.</p>
@@ -121,32 +120,29 @@ to transfer data to moodle on the Linux server.</p>
<p>Please read the full help file below before
using this import class.</p>
<p class="moreinfo"><a href="help.php?file=formatctm.html&amp;module=quiz">More info about the "CTM" format</a></p>
</div>
<h2>Embedded answers (Cloze)</h2>
<div class="indent">
<p>This special purpose format imports just one type of question, the
Embedded Answers (also known as Cloze) format.
</p>
<p class="moreinfo"><a href="help.php?file=multianswer.html&amp;module=quiz">More info about the "Cloze" format</a></p>
</div>
<h2>Learnwise format</h2>
<div class="indent">
<p>This format can import multiple choice questions saved in Learnwise's XML
format.</p>
</div>
<h2>Examview format</h2>
<div class="indent">
<p>This format can import from Examview 4 XML files. Note that the older
versions of Examview are not supported.</p>
</div>
<p>Import and Export formats are a pluggable resource. Other optional formats may be available in the
Modules and Plugins database.</p>