Go to most recent revision | Details | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
23 | reyssat | 1 | |
2 | <center><h3>Feedback according to answers</h3></center> <p> |
||
3 | |||
4 | You may define conditions (on the values of user answers) under which a |
||
5 | message will be printed on the page of results. A common use of this feature |
||
6 | will be to give warnings when a typical error to the exercise is detected. |
||
7 | <p> |
||
8 | An arbitrary number of feedbacks can be added, on any kind of replies |
||
9 | (freestyle or multiple choice). The syntax is as follows. |
||
10 | <p><tt> |
||
11 | \feedback{CONDITION}{MESSAGE} |
||
12 | </tt> <p> |
||
13 | The line can be put into the field of parameters (under guided mode) or |
||
14 | anywhere in the source (under raw mode). |
||
15 | <p> |
||
16 | When <tt>CONDITION</tt> is met, |
||
17 | <tt>MESSAGE</tt> will be shown to the user in the result page. Values of |
||
18 | user replies can be put into both via the variables <tt>\reply1</tt>, |
||
19 | <tt>\reply2</tt>,... (for freestyle replies), <tt>\choice1</tt>, |
||
20 | <tt>\choice2</tt>,... (for multiple choices). The order in the variables |
||
21 | is the order of their appearance in the source (or in the form under the |
||
22 | guided mode). |
||
23 | <p> |
||
24 | <tt>MESSAGE</tt> is a free text, accepting embedded html tags and |
||
25 | mathematical symbols. |
||
26 | |||
27 | <p> |
||
28 | One can use also the variables <tt>\sc_reply1</tt>, <tt>\sc_reply2</tt>, |
||
29 | ... which are equal to 1 in case of good user reply, 0 in case of false |
||
30 | user reply and 0.5 in case of good reply up to numerical precision. This variable |
||
31 | doesn't take care of conditions and is empty in the case where the |
||
32 | answer is analyzed only with conditions. |
||
33 | |||
34 | |||
35 | <p>$table_header |
||
36 | <caption>Examples of conditions |
||
37 | <small> |
||
38 | !href target=wims_mhelp cmd=help&special_parm=if complete list |
||
39 | </small> |
||
40 | </caption> |
||
41 | $table_hdtr<th>condition<th>when it is met |
||
42 | $table_tr<td><tt>\reply1=5<td>first freestyle reply is exactly equal to 5 |
||
43 | $table_tr<td><tt>\reply1>\reply2+2<td>first freestyle reply is > second one plus 2 |
||
44 | $table_tr<td><tt>\choice1=Yes and \choice2=No |
||
45 | <td>first multiple choice is Yes and second is No (<b>attention</b> the |
||
46 | comparison in multiple choices is case-sensitive!) |
||
47 | $table_tr<td><tt>\reply1<5 or \reply1>8 |
||
48 | <td>first reply is outside the range from 5 to 8. |
||
49 | $table_tr<td><tt>3 isitemof \reply1 |
||
50 | <td>the first reply, of type "set" or "vector", contains a component "3". |
||
51 | |||
52 | $table_end |
||
53 | <p> |
||
54 | <b>Known-bug</b>. You should avoid mixing <tt>\reply</tt> and |
||
55 | <tt>\choice</tt> within one same condition. Otherwise the result will be |
||
56 | unpredictable. |
||
57 |