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