A help file for Embedded Answers (Cloze)

diff --git a/lang/en/help/quiz/index.html b/lang/en/help/quiz/index.html
index 631773e2d6a57ce50b01f4fdd035a7b0ab5e844c..0b27e02a23ff0b6dac1773f2540dac0313054967 100644 (file)
--- a/lang/en/help/quiz/index.html
+++ b/lang/en/help/quiz/index.html
@@ -7,6 +7,7 @@
   <li><a href="help.php?module=quiz&file=createmultiple.html">Creating multiple quizzes</a>
   <li><a href="help.php?module=quiz&file=description.html">Descriptions</a>
   <li><a href="help.php?module=quiz&file=repeatattempts.html">Each attempt buids on the last</a>
+  <li><a href="help.php?module=quiz&file=multianswer.html">Embedded anwers (Cloze)</a>
   <li><a href="help.php?module=quiz&file=grademethod.html">Grading method</a>
   <li><a href="help.php?module=quiz&file=import.html">Importing questions</a>
   <li><a href="help.php?module=quiz&file=formatblackboard.html">Importing Blackboard quiz files</a>

diff --git a/lang/en/help/quiz/multianswer.html b/lang/en/help/quiz/multianswer.html
new file mode 100644 (file)
index 0000000..cea49b8
--- /dev/null
+++ b/lang/en/help/quiz/multianswer.html
@@ -0,0 +1,44 @@
+<p align="center"><b>Embedded answers (Cloze)</b></p>
+
+<p>This very flexible question type is similar to a 
+   popular format known as the Cloze format.  
+   
+<p>Questions consist of a passage of text (in Moodle format) that 
+   has various answers embedded within it, including multiple choice, 
+   short answers and numerical answers.
+
+<p>There is currently no graphical interface to create these questions - 
+   you need to specify the question format using the text box or by 
+   importing them from external files.
+   
+<p>Here is an example of the input text used to specify such a question:
+
+<form>
+<center>
+<textarea rows=15 cols=60 wrap=virtual>This question consists of some text with an answer embedded right here {1:MULTICHOICE:Wrong answer#Feedback for this wrong answer~Another wrong answer#Feedback for the other wrong answer~=Correct answer#Feedback for correct answer~%50%Answer that gives half the credit#Feedback for half credit answer} and right after that you will have to deal with this short answer {1:SHORTANSWER:Wrong answer#Feedback for this wrong answer~=Correct answer#Feedback for correct answer~%50%Answer that gives half the credit#Feedback for half credit answer} and finally we have a floating point number {2:NUMERICAL:=23.8:0.1#Feedback for correct answer 23.8~%50%N/A#Feedback for halfcredit answer in the nearby region of the correct answer}.
+
+Note that addresses like www.moodle.org and smileys :-) all work as normal:
+ a) How good is this? {:MULTICHOICE:=Yes#Correct~No#We have a different opinion}
+ b) What grade would you give it? {3:NUMERICAL:=3:2}
+
+Good luck!
+</textarea>
+</center>
+</form>
+
+<p>This example will appear to students as follows:</p>
+
+
+<form>
+<table align="CENTER" width="90%" class="generalbox" border="0" cellpadding="5" cellspacing="0"><tr><td bgcolor="#FFFFFF" class="generalboxcontent"><table width=100% cellspacing=10><tr><td nowrap width=100 valign=top><p align=center><b>3</b></p><p align=center><font size=1>8 Marks</font></p><img height="1" width="100" src="pix/spacer.gif" alt=""><br />
+</td><td valign=top><p>This question consists of some text with an answer embedded right here  <select   name="q4ma1" ><option></option><option value="4" >Wrong answer</option><option value="5" >Another wrong answer</option><option value="6" >Correct answer</option><option value="7" >Answer that gives half the credit</option></select>  and right after that you will have to deal with this short answer  <input   name="q4ma2"  value="" type="TEXT" size="8"/>  and finally we have a floating point number  <input   name="q4ma3"  value="" type="TEXT" size="8"/> .<br />\r
+<br />\r
+Note that addresses like <a href="http://www.moodle.org" target="newpage">www.moodle.org</a> and smileys <img alt=":-)" width=15 height=15 src="http://server.dougiamas.net/moodle/pix/s/smiley.gif"> all work as normal:<br />\r
+a) How good is this?  <select   name="q4ma4" ><option></option><option value="13" >Yes</option><option value="14" >No</option></select> <br />\r
+b) What grade would you give it?  <input   name="q4ma5"  value="" type="TEXT" size="8"/> <br />\r
+<br />\r
+Good luck!</p></TD></TR></TABLE></td></tr></table>
+</form>
+
+<br />
+