Subversion Repositories wimsdev

Rev

Rev 3350 | Rev 3987 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed

  1. !set typelist1=!trim\
  2. default,Auto,automatic determination of some basic types\
  3. raw,Raw text,control of comparison by options\
  4. numeric,Number, with tolerance of precision\
  5. function,Numerical function, function with numerical tests\
  6. equation,Numerical equation,equation with numerical tests\
  7. exp|algexp litexp formal,Mathematical expression, with formal comparison\
  8. text|case nocase,Text, words or sentences\
  9. multiple|checkbox click menu radio mark flashcard,Controlable multiple choices,buttons or menus\
  10.  
  11.  
  12. !set typelist2=!trim\
  13. atext,Approximative text, with identification of singular and plural etc.\
  14. chembrut,Raw formula of a molecule,in chemistry\
  15. chemdraw,Draw a molecule,with Java applet\
  16. chemclick,Select atoms or bonds in a molecule,with Java applet\
  17. chemeq,Chemical equation, with balance analysis\
  18. chset,Set of characters,\
  19. clickfill|clickfill dragfill,Drag-and-drop objets,text and image\
  20. clicktile,Click and color tiles, need java\
  21. compose,Compose, using given components\
  22. coord,Click on image, recognition of coordinates and various regions\
  23. correspond,Correspondance, establish the correspondance between pairs of objects\
  24. crossword,Crosswords\
  25. geogebra,Dynamic geometry,use applet GeoGebra\
  26. javacurve,Java draw,\
  27. jmolclick,Click on 3D atoms, use applet Jmol\
  28. keyboard,Text, with keyboard\
  29. matrix,Matrix, mathematical\
  30. numexp,Rational numbers, fractional writing\
  31. puzzle,Make in order an image, as in a puzzle\
  32. range,Number within a given range, anything within the range is accepted\
  33. reorder,Reordering, given list of objects\
  34. set|set fset aset,Finite set,literal, formal or approximative\
  35. sigunits,Sigunits,number with unit and significant digits\
  36. symtext,Symtext,advanced tool of text identification\
  37. units,Number with unit, for physics\
  38. vector,Vector,formal comparison of components\
  39. wlist,List of words,\
  40.  
  41.  
  42. !set namelist=Basic types, Specific or advanced types
  43. !set symtextlist=text atext raw compose
  44.  
  45.  
  46. <center><h3>User replies to an exercise</h3></center> <p>
  47.  
  48. There are two basic ways in which an OEF exercise accepts user replies:
  49. multiple choices and freestyle replies. User answers will be analyzed
  50. according to the nature of the types. It is also possible to show
  51. !href cmd=help&special_parm=feedback feedbacks
  52.  to the user when the answer meeds a specified condition (usually to warn a
  53. typical error).
  54.  
  55. <p><h4>Multiple choices</h4> <p>
  56. A multiple choice is defined by giving a list of good choices (one or
  57. several) and another list of bad choices. <p>
  58. Up to $choicelim simultaneous multiple choice questions can be asked for
  59. one exercise, under the current implementation. The number of good and bad
  60. choices within one multiple choice question is unlimited (except a limit on
  61. the length of the string imposed by WIMS).
  62. <p>
  63. See
  64. !href cmd=help&special_parm=oef help on OEF format
  65.  for the syntax to define a multiple choice.
  66. <p><h4>Freestyle answers</h4> <p>
  67. A freestyle answer is one which is typed by the user.
  68. Up to $answerlim simultaneous freestyle answers can be asked for one
  69. exercise, under the current implementation. <p>
  70. The syntax is as follows:
  71. <tt>\answer{Texte}{\reponse}{type=...}{option=...}{weight=...}</tt>
  72. <br>
  73. (The last 3 fields are optional.)
  74. <p>
  75.  
  76. <a name=freestyle></a>
  77. Each freestyle answer can independently take one of the following types.
  78.  
  79. !for i=1 to 2
  80.  <p><b>$(namelist[$i])</b>
  81.  !set n=!linecnt $(typelist$i)
  82.  <ul>
  83.  !for j=1 to $n
  84.   !set l=!line $j of $(typelist$i)
  85.   !distribute item $l into name,title
  86.   !set desc=!item 3 to -1 of $l
  87.   !set name=!replace internal | by , in $name
  88.   !set name1=!item 2 to -1 of $name
  89.   !set name=!item 1 of $name
  90.   !default name1=$name
  91.   !if $name isitemof $special_parm or all isitemof $special_parm
  92.    <li><p><a name="_$name"></a>
  93.    !read help/anstype/$name.phtml
  94.    !if $name iswordof $symtextlist
  95.     <p>
  96.     <b>Remark</b>.
  97.     This type of reply accepts the symtext option. If the word
  98.     <tt>symtext</tt> is declared in the option of the reply, the analysis of
  99.     the reply will be exactly as for
  100.     !href cmd=help&special_parm=reply,symtext#_symtext symtext
  101. , in particular with no preliminary processing of the texts. And all the
  102. symtext options will be understood in this case.
  103.    !endif
  104.    <p>
  105.   !else
  106.    <li>
  107.    !href cmd=help&special_parm=reply,$name#_$name $title
  108.   (<tt>$name1</tt>) $desc.
  109.   !endif
  110.  !next j
  111.  </ul>
  112. !next i
  113.  
  114. <p>
  115. Common option to freestyle answers: <tt>default</tt>. This option can take
  116. the form <tt><font color=green>default="default_value"</font></tt>. If the
  117. user gives an empty reply, it is the default_value that will take place.
  118.  
  119. <p><h4>Testing conditions</h4> <p>
  120. Under certain circumstances, it is desired that freestyle answers be tested
  121. by special conditions (questions with multiple good answers, exercises
  122. asking for examples, answers determined by inequalities, etc). This can be
  123. done in the following way. <p>
  124. If the good answer to a freestyle question is an undefined variable, the
  125. answer to this question will be fed into this variable. The latter can then
  126. be used to implement testing conditions. The score given to the exercise is
  127. then determined by the number of testing conditions which are met, rather
  128. than the number of answers which meet the good answers.
  129. <p>
  130. Up to $condlim simultaneous conditions can be defined for one
  131. exercise, under the current implementation. The syntax is as follows.
  132. <p><tt>
  133. \condition{prompt text}{testing conditions}{weight=...}
  134. </tt>
  135. (The last field is optional.)
  136. <p>
  137. Here are some examples of testing conditions. (<tt>\ans1</tt> and
  138. <tt>\ans2</tt> are undefined variables appearing in freestyle answers, as
  139. described above.)
  140. <small>
  141. !href target=wims_mhelp cmd=help&special_parm=if Complete list of relations
  142. </small>
  143. <p>
  144. $table_header
  145. $table_hdtr<th>Condition<th>meaning
  146. $table_tr<td><tt>\ans1>=0 and \ans1<=1</tt>
  147.     <td>Good if <tt>ans1</tt> is within the interval [0,1].
  148. $table_tr<td><tt>\ans1=1 or \ans1=3 or \ans1=5</tt>
  149.     <td>Good if <tt>ans1</tt> is 1, 3 or 5.
  150. $table_tr<td><tt>(\ans1)*(\ans2)=6 and (\ans1)+(\ans2)=5</tt>
  151.     <td>Good if <tt>ans1</tt> and <tt>ans2</tt> are the two
  152.     roots of the polynomial x<sup>2</sup>-5x+6.
  153. $table_tr<td><tt>sin(\ans1)=0</tt>
  154.     <td>Good if <tt>ans1</tt> is a multiple of $m_pi.
  155. $table_end <p>
  156. See
  157. !href cmd=help&special_parm=oef help on oef format
  158.  for the syntax for defining replies.
  159.  
  160. <h4>The optional parameter <tt>weight</tt></h4>
  161. <a name=weight></a>
  162. It is possible to give a weight to answers.
  163. <p>
  164. Example :
  165. <pre>\answer{}{1}{type=numeric}{weight=8}
  166. \answer{}{1}{type=numeric}{weight=2}
  167. </pre>
  168.  
  169.  
  170. One can put variables in <tt>weight</tt>.
  171. <p>
  172. Example :
  173. <pre>
  174. \text{w = \t = 1 ? 1 : 2}
  175. \answer{}{1}{type=numeric}{weight=\t}
  176. \answer{}{1}{type=numeric}{weight=3}
  177. </pre>
  178.  
  179. <h4>The optional parameter <tt>option</tt></h4>
  180.  <a name=option></a>
  181. The allowed options for <tt>\answer</tt>
  182. or <tt>\condition</tt> are
  183. <ul>
  184. <li>
  185. <tt>option=split</tt> : In case of type = <tt>correspond</tt>, <tt>checkbox</tt> or <tt>mark</tt>,
  186. there will be partial score.
  187. </li>
  188. <li>
  189. <tt>option=nonstop</tt> : In case of step exercises,
  190. following questions are asked even if the answer is false.
  191. </li>
  192. <li>Following <tt>condition</tt> :
  193. <tt>option=hide</tt> : The condition is used to analyze the
  194. answer but will not be printed.
  195. </li>
  196.  
  197. </ul>
  198.  
  199.