Subversion Repositories wimsdev

Rev

Rev 13774 | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 13774 Rev 17180
Line 1... Line 1...
1
<p>
1
<p>
2
The $wims_name_quick_GAP exercise type requires the learner to fill in blanks (i.e. gaps) 
2
The $wims_name_quick_GAP exercise type requires the learner to fill in blanks (i.e. gaps)
3
in a piece of text. 
3
in a piece of text.
4
There are several different types of GAP exercises:
4
There are several different types of GAP exercises:
5
</p>
5
</p>
6
     <ul>
6
     <ul>
7
       <li> <span class="tt">case</span>,<span class="tt">nocase</span>: the blank has to be filled in by typing letters 
7
       <li> <span class="tt">case</span>,<span class="tt">nocase</span>: the blank has to be filled in by typing letters
8
            (difference between lowercase and uppercase is not taking account with nocase).  </li>
8
            (difference between lowercase and uppercase is not taking account with nocase).  </li>
9
       <li> <span class="tt">clickfill</span>: words to be dragged and dropped in the blank</li>
9
       <li> <span class="tt">clickfill</span>: words to be dragged and dropped in the blank</li>
10
       <li> <span class="tt">dragfill</span>: words to be dragged and dropped in the blank(each word can 
10
       <li> <span class="tt">dragfill</span>: words to be dragged and dropped in the blank(each word can
11
       be used just once. Once used, the word disappears from the list of choices. )
11
       be used just once. Once used, the word disappears from the list of choices. )
12
       <li> <span class="tt">menu</span>: drop down menu</li>
12
       <li> <span class="tt">menu</span>: drop down menu</li>
13
       <li> <span class="tt">mark</span>: words to be clicked on</li>
13
       <li> <span class="tt">mark</span>: words to be clicked on</li>
14
     </ul>
14
     </ul>
15
<p>
15
<p>
16
You can decide how many attempts the learner may make before providing him/her with 
16
You can decide how many attempts the learner may make before providing him/her with
17
  the correct answers.
17
  the correct answers.
18
</p><p>
18
</p><p>
19
You can also decide to display or not the answers the learner has been unable to find 
19
You can also decide to display or not the answers the learner has been unable to find
20
at the end of the exercise.
20
at the end of the exercise.
21
</p><p>
21
</p><p>
22
After each attempt, only the wrongly answered blanks have to be completed by the learner. 
22
After each attempt, only the wrongly answered blanks have to be completed by the learner.
23
The correct answers will not have to be entered again.
23
The correct answers will not have to be entered again.
24
 
24
 
25
 You can decide to provide aids (the number of letters in the missing word(s), or some 
25
 You can decide to provide aids (the number of letters in the missing word(s), or some
26
 letters from the missing word(s), or the audio recording of the word(s) as long as it 
26
 letters from the missing word(s), or the audio recording of the word(s) as long as it
27
 is part of the swac audio collection or if you have previously recorded the word and 
27
 is part of the swac audio collection or if you have previously recorded the word and
28
 saved it in your Modtool account, a personalized message or the right answer is shown briefly).
28
 saved it in your Modtool account, a personalized message or the right answer is shown briefly).
29
Please enter the word you wish the learner to see when he/she uses the help function 
29
Please enter the word you wish the learner to see when he/she uses the help function
30
in the prompt section. The learner will be able to see the help provided if he/she hovers 
30
in the prompt section. The learner will be able to see the help provided if he/she hovers
31
over this prompt with the mouse (for example: aide, help, ayuda).
31
over this prompt with the mouse (for example: aide, help, ayuda).
32
</p><p>
32
</p><p>
33
Currently 39 blanks are allowed.
33
Currently 39 blanks are allowed.
34
</p><p>
34
</p><p>
35
Several correct answers may be provided for one blank.   
35
Several correct answers may be provided for one blank.
36
  In the <span class="tt">menu</span> and <span class="tt">mark</span> type GAP exercise, the <span class="tt">shared list</span> 
36
  In the <span class="tt">menu</span> and <span class="tt">mark</span> type GAP exercise, the <span class="tt">shared list</span>
37
  option allows you to suggest all the gapped out words in the text for the learner 
37
  option allows you to suggest all the gapped out words in the text for the learner
38
  to choose from in each blank.
38
  to choose from in each blank.
39
   
39
 
40
Otherwise at least two words (or group of words) have to be suggested for the learner 
40
Otherwise at least two words (or group of words) have to be suggested for the learner
41
to choose from in each blank (check the syntax). Additional words (distractors) can 
41
to choose from in each blank (check the syntax). Additional words (distractors) can
42
be provided as possible choices.
42
be provided as possible choices.
43
</p><p>
43
</p><p>
44
The list of words the learner will have to choose from can also be specified in 
44
The list of words the learner will have to choose from can also be specified in
45
the variable <span class="tt">choice</span> in the data file (see second example here below). 
45
the variable <span class="tt">choice</span> in the data file (see second example here below).
46
In this case the list will appear in the drop down menu for each blank whether 
46
In this case the list will appear in the drop down menu for each blank whether
47
you have activated the  <span class="tt">shared list</span> option or not.
47
you have activated the  <span class="tt">shared list</span> option or not.
48
</p>
48
</p>
49
:format
49
:format
50
<pre>
50
<pre>
51
:He's not ??there,their,theirs?? today !
51
:He's not ??there,their,theirs?? today !
52
:Those students over ??there,their,theirs??  are naughty so
52
:Those students over ??there,their,theirs??  are naughty so
53
??their,there,theirs??  teacher is cross.
53
??their,there,theirs??  teacher is cross.
54
:Those books over ??there,their,theirs??  in ??their,there,theirs?? 
54
:Those books over ??there,their,theirs??  in ??their,there,theirs??
55
bags are not??theirs,there,their?? but mine.
55
bags are not??theirs,there,their?? but mine.
56
:I'm going ??there,their,theirs?? to see ??their,there,theirs?? friends.
56
:I'm going ??there,their,theirs?? to see ??their,there,theirs?? friends.
57
</pre>
57
</pre>
58
<h3>$wims_name_Syntax</h3>
58
<h3>$wims_name_Syntax</h3>
59
Gaps are marked with ??word(s)??. The correct word(s) must be written in the first position,
59
Gaps are marked with ??word(s)??. The correct word(s) must be written in the first position,
60
wrong alternatives in the second, third and subsequent positions. 
60
wrong alternatives in the second, third and subsequent positions.
61
Here below is an example of the syntax
61
Here below is an example of the syntax
62
 
62
 
63
<pre>
63
<pre>
64
:text ??correct word(s) for the 1st gap,1st wrong word(s) for the 1st gap, 2nd wrong word(s) for the 1st gap?? 
64
:text ??correct word(s) for the 1st gap,1st wrong word(s) for the 1st gap, 2nd wrong word(s) for the 1st gap??
65
text ??correct word(s) for the 2nd gap,1st wrong word(s) for the 2nd gap?? text 
65
text ??correct word(s) for the 2nd gap,1st wrong word(s) for the 2nd gap?? text
66
??correct word(s) for the 3rd gap,1st wrong word(s) for the 3rd gap?? text 
66
??correct word(s) for the 3rd gap,1st wrong word(s) for the 3rd gap?? text
67
??correct word(s) for the 4th gap,1st wrong word(s) for the 4th gap,2nd wrong word(s) for the 4th gap?? text 
67
??correct word(s) for the 4th gap,1st wrong word(s) for the 4th gap,2nd wrong word(s) for the 4th gap?? text
68
</pre>
68
</pre>
69
 
69
 
70
<span class="wims_warning">$wims_name_remark</span>: If there are only a few words 
70
<span class="wims_warning">$wims_name_remark</span>: If there are only a few words
71
to choose from, these can be listed in the variable called<span class="tt">choice</span>.
71
to choose from, these can be listed in the variable called<span class="tt">choice</span>.
72
Distractors can be added to this list as well. The syntax will slightly change and will be
72
Distractors can be added to this list as well. The syntax will slightly change and will be
73
<pre>
73
<pre>
74
choice= correct word(s) for the 1st gap,correct word(s) for the 2nd gap,correct word(s) for the 3rd gap,1st distractor,2nd distractor
74
choice= correct word(s) for the 1st gap,correct word(s) for the 2nd gap,correct word(s) for the 3rd gap,1st distractor,2nd distractor
75
:text ??correct word(s) for the 1st gap?? text ??correct word(s) for the 2nd gap?? text
75
:text ??correct word(s) for the 1st gap?? text ??correct word(s) for the 2nd gap?? text
76
??correct word(s) for the 3rd gap?? text ??correct word(s) for the 2nd gap??
76
??correct word(s) for the 3rd gap?? text ??correct word(s) for the 2nd gap??
77
</pre>
77
</pre>
78
<span class="wims_warning">$wims_name_remark</span>: In order to increase the number of sentences 
78
<span class="wims_warning">$wims_name_remark</span>: In order to increase the number of sentences
79
that appear in an exercise, certain words can be written between braces { }
79
that appear in an exercise, certain words can be written between braces { }
80
i.e. {altenative1,alternative2,alternative3}.
80
i.e. {altenative1,alternative2,alternative3}.
81
A comma must be used to separate the words in the braces. A different word (or piece of text) 
81
A comma must be used to separate the words in the braces. A different word (or piece of text)
82
will be selected randomly by the software program every 
82
will be selected randomly by the software program every
83
time the learner renews the exercise. If the text contains commas, the commas 
83
time the learner renews the exercise. If the text contains commas, the commas
84
must be replaced by their html code which is
84
must be replaced by their html code which is
85
(&amp;#44;)
85
(&amp;#44;)
86
<pre>
86
<pre>
87
:{I am,He is,She is,They are,Mary is} ??there?? !
87
:{I am,He is,She is,They are,Mary is} ??there?? !
88
:Those {students,children,boys,girls} over ??there?? are naughty, so
88
:Those {students,children,boys,girls} over ??there?? are naughty, so
89
{??their?? teacher is cross., 
89
{??their?? teacher is cross.,
90
??their?? headmaster will be angry.}
90
??their?? headmaster will be angry.}
91
:Those books over ??there?? in ??their?? 
91
:Those books over ??there?? in ??their??
92
bags are not??theirs?? but {mine,Peter's,hers,Mary's}.
92
bags are not??theirs?? but {mine,Peter's,hers,Mary's}.
93
:{I'm going,He's running,They are walking}??there?? to see ??their?? {friends,parents,brother,grandparents}.
93
:{I'm going,He's running,They are walking}??there?? to see ??their?? {friends,parents,brother,grandparents}.
94
</pre>
94
</pre>
95
 
95
 
96
<span class="wims_warning">$wims_name_remark</span>: When there are several possible correct answers, 
96
<span class="wims_warning">$wims_name_remark</span>: When there are several possible correct answers,
97
they have to be separated by  | . For example,
97
they have to be separated by  | . For example,
98
<pre>
98
<pre>
99
:first possible correct word(s)|second possible correct word(s)|third possible correct word(s),distractor??
99
:first possible correct word(s)|second possible correct word(s)|third possible correct word(s),distractor??
100
:The ??organisation|organization,organize?? of this meeting is difficult.
100
:The ??organisation|organization,organize?? of this meeting is difficult.
101
</pre>
101
</pre>
102
<p>
102
<p>
103
If the learner provides a wrong answer, the first correct answer in the list will be suggested as the right answer. 
103
If the learner provides a wrong answer, the first correct answer in the list will be suggested as the right answer.
104
(<span class="tt">organisation</span> in the example above)
104
(<span class="tt">organisation</span> in the example above)
105
</p><p>
105
</p><p>
106
<span class="wims_warning">$wims_name_remark</span>: Preferences for a data set.
106
<span class="wims_warning">$wims_name_remark</span>: Preferences for a data set.
107
 
107
 
108
If you wish to add a different audio recording, a different title (i.e. text) or 
108
If you wish to add a different audio recording, a different title (i.e. text) or
109
a different introduction to each data set (i.e. exercise), the first line must have the following format
109
a different introduction to each data set (i.e. exercise), the first line must have the following format
110
</p>
110
</p>
111
<pre>
111
<pre>
112
:audio=recording_file.mp3 image=picture_file.jpg title="your text" intro="instructions" 
112
:audio=recording_file.mp3 image=picture_file.jpg title="your text" intro="instructions"
113
</pre>
113
</pre>
114
<span class="wims_warning">$wims_name_remark</span>: Adding a personalised aid. You may want
114
<span class="wims_warning">$wims_name_remark</span>: Adding a personalised aid. You may want
115
to add one or more personalised aids for each (or certain) blank in a 'case' type gapfill exercise. If you add
115
to add one or more personalised aids for each (or certain) blank in a 'case' type gapfill exercise. If you add
116
several aids for the same blanks, one will be drawn randomly and displayed.
116
several aids for the same blanks, one will be drawn randomly and displayed.
117
In this case the following format is required.
117
In this case the following format is required.
118
<pre>text text ??gap //help=[{personalised aid number 1}]?? 
118
<pre>text text ??gap //help=[{personalised aid number 1}]??
119
text text text text ??gap //help=[{personalised aid number 2}]?? text text<br />
119
text text text text ??gap //help=[{personalised aid number 2}]?? text text<br>
120
for example : My ??sister //help=[{opposite of brother, a family member}] is coming to Paris tomorrow.
120
for example : My ??sister //help=[{opposite of brother, a family member}] is coming to Paris tomorrow.
121
</pre>
121
</pre>
122
 
122