Changing import/export help to be properly pluggable.
-<h1>Importing "Aiken" format files</h1>
+<h1>"Aiken" format files</h1>
-<p>The Aiken format is a very simple way of creating multiple choice questions using a clear human-readable format. Here is an example of the format:</p>
+<p>The Aiken format is a very simple way of creating multiple choice questions using a clear human-readable format.
+Here is an example of the format:</p>
<pre>
What is the correct answer to this question?
A. Is it this one?
--- /dev/null
+<h1>Blackboard (POOL) Files</h1>
+
+<p>This module can import questions saved in Blackboard's "POOL" type export
+format. This is generally for Blackboard versions 5 and earlier although
+many other quiz packages use this as their "Blackboard" export format. </p>
+
+<p>
+To use this first unpack the exported zip file and provide Moodle
+with the appropriate .dat file. Do not try to import the zip file directly</p>
+
+<p>Note that this version <strong>does not</strong> work with Blackboard
+Version 6 and newer.</p>
--- /dev/null
+<h1>Blackboard V6+ files</h1>
+
+<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>
+
+<p>Note that this format only imports the main data file from
+the zip. Any other data (e.g. images) is ignored.</p>
\ No newline at end of file
--- /dev/null
+<h1>Examview format</h1>
+
+<p>This format can import from Examview 4 XML files. Note that the older
+versions of Examview are not supported. Examview no longer supports this
+export format. You are advised the use BlackBoard format instead.</p>
-<h1>Importing "GIFT" format files</h1>
-<p>GIFT is the most comprehensive import format available for importing
- Moodle quiz questions from a text file. It supports Multiple-Choice,
+<h1>"GIFT" format files</h1>
+
+<p>GIFT is the most comprehensive import format available for importing and exporting
+ Moodle quiz questions from/to a text file. It supports Multiple-Choice,
True-False, Short Answer, Matching and Numerical questions, as well as insertion
of a _____ for the Missing Word format. Various question-types can be
mixed in a single text file, and the format also supports line comments,
question names, feedback and percentage-weight grades.</p>
+
+<p>Optional questiontype plugins can extend this format</p>
<p>The text encoding of your text file must be utf-8 (unless you only use ascii characters).
An example questions text file can be found here: <a href="<?php echo $CFG->wwwroot; ?>/question/format/gift/examples.txt">gift/examples.txt</a>.</p>
--- /dev/null
+<h1>Hot Potatoes Files</h1>
+
+<p>This format will import files created in Hot Potatoes.</p>
\ No newline at end of file
--- /dev/null
+<h1>Learnwise format</h1>
+
+<p>This format can import multiple choice questions saved in Learnwise's XML
+format.</p>
+
--- /dev/null
+<h1>Missing Word Format</h1>
+
+<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
+generate a multiple choice question.
+Each answer is separated with a tilde (~), and the correct answer is
+prefixed with an equals sign (=). Here is an example of a multiple
+choice question:</p>
+
+<blockquote><p>As soon as we begin to explore our body parts as infants
+we become students of {=anatomy and physiology ~reflexology
+~science ~experiment}, and in a sense we remain students for life.
+</p></blockquote>
+
+<p>Here is an example of a short answer question:</p>
+
+<blockquote><p>As soon as we begin to explore our body parts as infants
+ we become students of {=anatomy and physiology},
+ and in a sense we remain students for life.
+</p></blockquote>
\ No newline at end of file
--- /dev/null
+<h1>Embedded answers (Cloze)</h1>
+
+<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&module=quiz">More info about the "Cloze" format</a></p>
\ No newline at end of file
-<h1>Importing "Moodle XML" format files</h1>
+<h1>"Moodle XML" format</h1>
+
+<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>Optional questiontype plugins can extend this format.</p>
<h3>Category Switching</h3>
XML based import formats will be handled
automatically provided your Moodle server is running PHP 5.</p>
-<p>A number of file formats are supported:</p>
-
-
-<h2>GIFT format</h2>
-
-<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,
- True-False, Short Answer, Matching and Numerical questions, as well as insertion
- of a _____ for the "missing word" format. Various question-types can be
- mixed in a single text file, and the format also supports line comments, question names,
- feedback and percentage-weight grades. Below are some examples:</p>
-<pre>
-Who's buried in Grant's tomb?{~Grant ~Jefferson =no one}
-
-Grant is {~buried =entombed ~living} in Grant's tomb.
-
-Grant is buried in Grant's tomb.{FALSE}
-
-Who's buried in Grant's tomb?{=no one =nobody}
-
-When was Ulysses S. Grant born?{#1822}
-</pre>
-
-<p class="moreinfo"><a href="help.php?file=formatgift.html&module=quiz">More info about the "GIFT" format</a></p>
-
-
-<h2>Aiken Format</h2>
-
-<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&module=quiz">More info about the "Aiken" format</a></p>
-
-
-<h2>Moodle XML format</h2>
-
-<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&module=quiz">More info about the "Moodle XML" format</a></p>
-
-
-<h2>Missing Word</h2>
-
-<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
-generate a multiple choice question.
-Each answer is separated with a tilde (~), and the correct answer is
-prefixed with an equals sign (=). Here is an example of a multiple
-choice question:</p>
-
-<blockquote><p>As soon as we begin to explore our body parts as infants
-we become students of {=anatomy and physiology ~reflexology
-~science ~experiment}, and in a sense we remain students for life.
-</p></blockquote>
-
-<p>Here is an example of a short answer question:</p>
-
-<blockquote><p>As soon as we begin to explore our body parts as infants
- we become students of {=anatomy and physiology},
- and in a sense we remain students for life.
-</p></blockquote>
-
-
-<h2>Blackboard</h2>
-
-<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>
-
-
-<h2>Blackboard V6+</h2>
-
-<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>
-
-
-<h2>WebCT</h2>
-
-<p>This module can import questions saved in WebCT's text-based format.</p>
-
-<p class="moreinfo"><a href="help.php?file=formatwebct.html&module=quiz">More info about the "WebCT" format</a></p>
-
-
-<h2>Embedded answers (Cloze)</h2>
-
-<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&module=quiz">More info about the "Cloze" format</a></p>
-
-
-<h2>Learnwise format</h2>
-
-<p>This format can import multiple choice questions saved in Learnwise's XML
-format.</p>
-
-
-<h2>Examview format</h2>
-
-<p>This format can import from Examview 4 XML files. Note that the older
-versions of Examview are not supported.</p>
+<p>A number of file formats are supported. See in the individual help files
+and the <a href="http://docs.moodle.org/en/question/import">Moodle Docs</a>
+for details.</p>
<p>Import and Export formats are a pluggable resource. Other optional formats may be available in the
projects / moodle.git / commitdiff