From 08b82a53f3ee261b4cbc9c0b9650a82fc48e77e7 Mon Sep 17 00:00:00 2001 From: thepurpleblob Date: Wed, 9 Jul 2008 12:56:54 +0000 Subject: [PATCH] MDL-14431 Changing import/export help to be properly pluggable. --- lang/en_utf8/help/quiz/formataiken.html | 5 +- lang/en_utf8/help/quiz/formatblackboard.html | 12 ++ .../en_utf8/help/quiz/formatblackboard_6.html | 9 ++ lang/en_utf8/help/quiz/formatexamview.html | 5 + lang/en_utf8/help/quiz/formatgift.html | 9 +- lang/en_utf8/help/quiz/formathotpot.html | 3 + lang/en_utf8/help/quiz/formatlearnwise.html | 5 + lang/en_utf8/help/quiz/formatmissingword.html | 21 ++++ lang/en_utf8/help/quiz/formatmultianswer.html | 7 ++ lang/en_utf8/help/quiz/formatxml.html | 10 +- lang/en_utf8/help/quiz/import.html | 113 +----------------- 11 files changed, 83 insertions(+), 116 deletions(-) create mode 100644 lang/en_utf8/help/quiz/formatblackboard.html create mode 100644 lang/en_utf8/help/quiz/formatblackboard_6.html create mode 100644 lang/en_utf8/help/quiz/formatexamview.html create mode 100644 lang/en_utf8/help/quiz/formathotpot.html create mode 100644 lang/en_utf8/help/quiz/formatlearnwise.html create mode 100644 lang/en_utf8/help/quiz/formatmissingword.html create mode 100644 lang/en_utf8/help/quiz/formatmultianswer.html diff --git a/lang/en_utf8/help/quiz/formataiken.html b/lang/en_utf8/help/quiz/formataiken.html index bb30fcc8ce..15110dfa4c 100644 --- a/lang/en_utf8/help/quiz/formataiken.html +++ b/lang/en_utf8/help/quiz/formataiken.html @@ -1,6 +1,7 @@ -

Importing "Aiken" format files

+

"Aiken" format files

-

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:

+

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:

 What is the correct answer to this question?
 A. Is it this one?
diff --git a/lang/en_utf8/help/quiz/formatblackboard.html b/lang/en_utf8/help/quiz/formatblackboard.html
new file mode 100644
index 0000000000..6e94c4f1e7
--- /dev/null
+++ b/lang/en_utf8/help/quiz/formatblackboard.html
@@ -0,0 +1,12 @@
+
Blackboard (POOL) Files

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

+
+

+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

+
+
Note that this version does not work with Blackboard
+Version 6 and newer.

diff --git a/lang/en_utf8/help/quiz/formatblackboard_6.html b/lang/en_utf8/help/quiz/formatblackboard_6.html
new file mode 100644
index 0000000000..0d2bdd74bf
--- /dev/null
+++ b/lang/en_utf8/help/quiz/formatblackboard_6.html
@@ -0,0 +1,9 @@
+
Blackboard V6+ files

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

+
+
Note that this format only imports the main data file from 
+the zip. Any other data (e.g. images) is ignored.

\ No newline at end of file
diff --git a/lang/en_utf8/help/quiz/formatexamview.html b/lang/en_utf8/help/quiz/formatexamview.html
new file mode 100644
index 0000000000..17d9cba7d5
--- /dev/null
+++ b/lang/en_utf8/help/quiz/formatexamview.html
@@ -0,0 +1,5 @@
+
Examview format

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

diff --git a/lang/en_utf8/help/quiz/formatgift.html b/lang/en_utf8/help/quiz/formatgift.html
index 75ad58a018..427066ed25 100644
--- a/lang/en_utf8/help/quiz/formatgift.html
+++ b/lang/en_utf8/help/quiz/formatgift.html
@@ -1,10 +1,13 @@
-
Importing "GIFT" format files

-
GIFT is the most comprehensive import format available for importing 
-   Moodle quiz questions from a text file.  It supports Multiple-Choice, 
+
"GIFT" format files

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

+   
+
Optional questiontype plugins can extend this format
   
 
     
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: gift/examples.txt.

diff --git a/lang/en_utf8/help/quiz/formathotpot.html b/lang/en_utf8/help/quiz/formathotpot.html
new file mode 100644
index 0000000000..6ec99c3f38
--- /dev/null
+++ b/lang/en_utf8/help/quiz/formathotpot.html
@@ -0,0 +1,3 @@
+
Hot Potatoes Files

+
+
This format will import files created in Hot Potatoes.

\ No newline at end of file
diff --git a/lang/en_utf8/help/quiz/formatlearnwise.html b/lang/en_utf8/help/quiz/formatlearnwise.html
new file mode 100644
index 0000000000..aaf8978f9d
--- /dev/null
+++ b/lang/en_utf8/help/quiz/formatlearnwise.html
@@ -0,0 +1,5 @@
+
Learnwise format

+
+
This format can import multiple choice questions saved in Learnwise's XML
+format.

+
diff --git a/lang/en_utf8/help/quiz/formatmissingword.html b/lang/en_utf8/help/quiz/formatmissingword.html
new file mode 100644
index 0000000000..6830d4d2ef
--- /dev/null
+++ b/lang/en_utf8/help/quiz/formatmissingword.html
@@ -0,0 +1,21 @@
+
Missing Word Format

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

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

+
+
Here is an example of a short answer question:

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

\ No newline at end of file
diff --git a/lang/en_utf8/help/quiz/formatmultianswer.html b/lang/en_utf8/help/quiz/formatmultianswer.html
new file mode 100644
index 0000000000..f720b3c74e
--- /dev/null
+++ b/lang/en_utf8/help/quiz/formatmultianswer.html
@@ -0,0 +1,7 @@
+
Embedded answers (Cloze)

+
+
This special purpose format imports just one type of question, the 
+Embedded Answers (also known as Cloze) format.
+

+
+
More info about the "Cloze" format

\ No newline at end of file
diff --git a/lang/en_utf8/help/quiz/formatxml.html b/lang/en_utf8/help/quiz/formatxml.html
index f72619de49..6efac8a226 100644
--- a/lang/en_utf8/help/quiz/formatxml.html
+++ b/lang/en_utf8/help/quiz/formatxml.html
@@ -1,4 +1,12 @@
-
Importing "Moodle XML" format files

+
"Moodle XML" format

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

+
+
Optional questiontype plugins can extend this format.

 
 
Category Switching

 
diff --git a/lang/en_utf8/help/quiz/import.html b/lang/en_utf8/help/quiz/import.html
index 676b53a931..5b5387cf79 100644
--- a/lang/en_utf8/help/quiz/import.html
+++ b/lang/en_utf8/help/quiz/import.html
@@ -15,116 +15,9 @@
    XML based import formats will be handled
    automatically provided your Moodle server is running PHP 5.
 
 
-
A number of file formats are supported:

-
-
-
GIFT format

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

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

-
-
More info about the "GIFT" format

-
-
-
Aiken Format

-
-
This is a simple format for importing multiple choice questions from a text file.

-
More info about the "Aiken" format

-
-
-
Moodle XML format

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

-
More info about the "Moodle XML" format

-
-
-
Missing Word

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

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

-
-
Here is an example of a short answer question:

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

-
-
-
Blackboard

-
-
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 does not work with Blackboard
-Version 6 and newer.

-
-
-
Blackboard V6+

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

-
-
-
WebCT

-
-
This module can import questions saved in WebCT's text-based format.

-
-
More info about the "WebCT" format

-
-
-
Embedded answers (Cloze)

-
-
This special purpose format imports just one type of question, the 
-Embedded Answers (also known as Cloze) format.
-

-
-
More info about the "Cloze" format

-
-
-
Learnwise format

-
-
This format can import multiple choice questions saved in Learnwise's XML
-format.

-
-
-
Examview format

-
-
This format can import from Examview 4 XML files. Note that the older
-versions of Examview are not supported.

+
A number of file formats are supported. See in the individual help files
+and the Moodle Docs
+for details.

 
 
 
Import and Export formats are a pluggable resource. Other optional formats may be available in the
-- 
2.39.5