WebSVN – wimsdev – Diff – /trunk/wims/public_html/scripts/help/en/oefcommand



 
:Command list
 
:directive,number of<br/>parameters,description,optional parameters,recognized option words
 
:title
1
defines the title of the exercise
 
:language
1
defines the language of the exercise, such as <span class="tt wims_code_words">en</span> or <span class="tt wims_code_words">fr</span>
 
:author
1
defines the author of the exercise. Write it in the form <span class="tt wims_code_words">firstname, lastname</span> (in case of multiple authors, use a semicolon between them).
 
:email
1
defines the author's email (in case of multiple authors, use a comma between the addresses).
 
:format
1
format of the statement
 
 
help=format
:css
1
defines css style
 
:precision
1
precision in comparing user's reply with the solution. Give a positive integer n here: the comparison will be done to the precision of 1/n.
 
:range
1
variable range when evaluating a function supplied by the user. Should be given in the form <span class="tt wims_code_words">n1..n2</span>, where n1 is the start point, n2 is the end point.
 
:computeanswer
1
The instruction <span class="tt wims_code_words">\computeanswer{ no }</span> specifies that the user should complete calculations by himself and enter the final value. On the other hand, if we specify <span class="tt wims_code_words">\computeanswer{ yes }</span>, the user may enter a formula like <span class="tt wims_code_words">5*5</span>,  letting the computer make the calculations.
 
:statement
1
the parameter is the statement of the exercise. Can be used only one time in the exercise.
 
:answer
2-5
defines a freestyle answer. The first parameter is the prompt of the answer, and the second is the good answer.  Such an answer can be tested according to many different types: number, function, text, etc.
type option weight
 
reorder shuffle nonstop
help=reply
 
:choice
3-5
defines a multiple choice. The first parameter is the prompt of the choice, the second the good choice(s), and the third the other choice(s). The last two parameters may (should) be a comma-separated list. Multiple good choices are allowed. If a choice appears in both good and bad choice lists, it will be taken as good.
option weight
shuffle noidontknow
 
:condition
2-4
defines a special condition for the evaluation of freestyle answers.
option weight
 
help=reply
 
:solution
1
gives the solution of the exercise with explanation. The OEF manager may decide on whether to show this explained solution to the user, according to the user setup of the difficulty level. Can be used only one time in the exercise. 
 
:hint
1
gives a hint of the exercise. The OEF manager may decide on whether to show the hint, according to the user setup of the difficulty level. Can be used only one time in the exercise. 
 
:help
1
gives a help to the exercise. This help will always be accessible to the user, in a popup window. Can be used only one time in the exercise. 
 
:feedback
2
gives a feedback warning to the user when the answer meeds a specified condition. Usually to warn of a typical error.
 
 
help=feedback
 
:steps
1
defines the questions of each step of the exercise ; must be before the instruction <span class="tt wims_code_words">statement</span> (see the variable <span class="tt wims_code_words">\step</span>). Can be used only one time in the exercise. 
 
 
:nextstep
1
defines the questions of each step of the exercise in a dynamic way ; must be before the instruction <span class="tt wims_code_words">statement</span> (see the variable <span class="tt wims_code_words">\step</span>). Can be used only one time in the exercise. 
 
 
:conditions
1
defines the numbers of the conditions useful for the exercise.
 
:latex
1
allows to write a latex version of the exercise using the variables defined in the exercise and downloadable in the printable version of the exercise (accessible only by developers or teachers of a class). It is advisable to put the statement in a predefined environment latex <span class="tt wims_code_words">\begin{statement} \end{statement}</span> and the solution in the environment <span class="tt wims_code_words">\begin{sol} ... \end{sol}</span>.
 
:credits
1
allows to insert credits at the end of the exercise (variables are evaluated).

Rev 5903	Rev 8552
Line 1...	Line -...
1		-
2	:Command list	1	:Command list
3		2
4	:directive,number of<br/>parameters,description,optional parameters,recognized option ~~word~~	3	:directive,number of<br/>parameters,description,optional parameters,recognized option words
-		4
5	:title	5	:title
6	1	6	1
7	defines the title of the exercise	7	defines the title of the exercise
-		8
8	:language	9	:language
9	1	10	1
10	defines the language of the exercise, such as <span class="tt wims_code_words">en</span> or <span class="tt wims_code_words">fr</span>	11	defines the language of the exercise, such as <span class="tt wims_code_words">en</span> or <span class="tt wims_code_words">fr</span>
-		12
11	:author	13	:author
12	1	14	1
13	defines the author of the exercise. Write it in the form <span class="tt wims_code_words">firstname, lastname</span> (in case of multiple authors, use a semicolon between them).	15	defines the author of the exercise. Write it in the form <span class="tt wims_code_words">firstname, lastname</span> (in case of multiple authors, use a semicolon between them).
-		16
14	:email	17	:email
15	1	18	1
16	defines the author's email (in case of multiple authors, use a comma between the addresses).	19	defines the author's email (in case of multiple authors, use a comma between the addresses).
-		20
17	:format	21	:format
18	1	22	1
19	format of the statement	23	format of the statement
20		24
21		25
22	help=format	26	help=format
23	:css	27	:css
24	1	28	1
25	defines css style	29	defines css style
-		30
26	:precision	31	:precision
27	1	32	1
28	precision in comparing user's reply with the solution. Give a positive integer n here: the comparison will be done to the precision of 1/n.	33	precision in comparing user's reply with the solution. Give a positive integer n here: the comparison will be done to the precision of 1/n.
-		34
29	:range	35	:range
30	1	36	1
31	variable range when evaluating a function supplied by the user. Should be given in the form <span class="tt wims_code_words">n1..n2</span>, where n1 is the start point, n2 is the end point.	37	variable range when evaluating a function supplied by the user. Should be given in the form <span class="tt wims_code_words">n1..n2</span>, where n1 is the start point, n2 is the end point.
-		38
-		39	:computeanswer
-		40	1
-		41	The instruction <span class="tt wims_code_words">\computeanswer{ no }</span> specifies that the user should complete calculations by himself and enter the final value. On the other hand, if we specify <span class="tt wims_code_words">\computeanswer{ yes }</span>, the user may enter a formula like <span class="tt wims_code_words">5*5</span>, letting the computer make the calculations.
32		42
33	:statement	43	:statement
34	1	44	1
35	the parameter is the statement of the exercise. Can be used only one time in the exercise.	45	the parameter is the statement of the exercise. Can be used only one time in the exercise.
36		46
37	:answer	47	:answer
38	2-5	48	2-5
39	defines a freestyle answer. The first parameter is the prompt of the answer, and the second is the good answer. Such an answer can be tested according to many different types: number, function, text, etc.	49	defines a freestyle answer. The first parameter is the prompt of the answer, and the second is the good answer. Such an answer can be tested according to many different types: number, function, text, etc.
40	type option weight	50	type option weight
41		-
-		51	reorder shuffle nonstop
42	help=reply	52	help=reply
-		53
43	:choice	54	:choice
44	3-5	55	3-5
45	defines a multiple choice. The first parameter is the prompt of the choice, the second the good choice(s), and the third the other choice(s). The last two parameters may (should) be a comma-separated list. Multiple good choices are allowed. If a choice appears in both good and bad choice lists, it will be taken as good.	56	defines a multiple choice. The first parameter is the prompt of the choice, the second the good choice(s), and the third the other choice(s). The last two parameters may (should) be a comma-separated list. Multiple good choices are allowed. If a choice appears in both good and bad choice lists, it will be taken as good.
46	option weight	57	option weight
47	shuffle noidontknow	58	shuffle noidontknow
-		59
48	:condition	60	:condition
49	2-4	61	2-4
50	defines a special condition for the evaluation of freestyle answers.	62	defines a special condition for the evaluation of freestyle answers.
51	option weight	63	option weight
52		64
53	help=reply	65	help=reply
-		66
54	:solution	67	:solution
55	1	68	1
56	gives the solution of the exercise with explanation. The OEF manager may decide on whether to show this explained solution to the user, according to the user setup of the difficulty level. Can be used only one time in the exercise.	69	gives the solution of the exercise with explanation. The OEF manager may decide on whether to show this explained solution to the user, according to the user setup of the difficulty level. Can be used only one time in the exercise.
-		70
57	:hint	71	:hint
58	1	72	1
59	gives a hint of the exercise. The OEF manager may decide on whether to show the hint, according to the user setup of the difficulty level. Can be used only one time in the exercise.	73	gives a hint of the exercise. The OEF manager may decide on whether to show the hint, according to the user setup of the difficulty level. Can be used only one time in the exercise.
-		74
60	:help	75	:help
61	1	76	1
62	gives a help to the exercise. This help will always be accessible to the user, in a popup window. Can be used only one time in the exercise.	77	gives a help to the exercise. This help will always be accessible to the user, in a popup window. Can be used only one time in the exercise.
-		78
63	:feedback	79	:feedback
64	2	80	2
65	gives a feedback warning to the user when the answer meeds a specified condition. Usually to warn of a typical error.	81	gives a feedback warning to the user when the answer meeds a specified condition. Usually to warn of a typical error.
66		82
67		83
68	help=feedback	84	help=feedback
-		85
69	:steps	86	:steps
70	1	87	1
71	~~define~~ the questions of each step of the exercise ; must be before the instruction <span class="tt wims_code_words">statement</span> (see the variable <span class="tt wims_code_words">\step</span>). Can be used only one time in the exercise.	88	defines the questions of each step of the exercise ; must be before the instruction <span class="tt wims_code_words">statement</span> (see the variable <span class="tt wims_code_words">\step</span>). Can be used only one time in the exercise.
72		-
73		89
74	:nextstep	90	:nextstep
75	1	91	1
76	~~define~~ the questions of each step of the exercise in a dynamic way ; must be before the instruction <span class="tt wims_code_words">statement</span> (see the variable <span class="tt wims_code_words">\step</span>). Can be used only one time in the exercise.	92	defines the questions of each step of the exercise in a dynamic way ; must be before the instruction <span class="tt wims_code_words">statement</span> (see the variable <span class="tt wims_code_words">\step</span>). Can be used only one time in the exercise.
77		-
78		93
79	:conditions	94	:conditions
80	1	95	1
81	~~define~~ the numbers of the conditions useful for the exercise.	96	defines the numbers of the conditions useful for the exercise.
82		97
83	:latex	98	:latex
84	1	99	1
85	~~permet~~ ~~d'écrire~~ ~~une~~ ~~version en latex de l'exercice utilisant les variables définies dans l'exercice et pouvant être téléchargées dans la version imprimable de l'exercice (accessible uniquement~~ ~~par~~ ~~les développeurs ou~~ ~~les~~ ~~enseignants~~ ~~d'une~~ ~~classe~~). ~~Il est conseillé de mettre l'énoncé dans~~ un ~~environnement~~ ~~latex~~ ~~prédéfini~~ <span class="tt wims_code_words">\begin{statement} \end{statement}</span> et la solution ~~dans~~ ~~l'environnement~~ <span class="tt wims_code_words">\begin{sol} ... \end{sol}</span>.	100	allows to write a latex version of the exercise using the variables defined in the exercise and downloadable in the printable version of the exercise (accessible only by developers or teachers of a class). It is advisable to put the statement in a predefined environment latex <span class="tt wims_code_words">\begin{statement} \end{statement}</span> and the solution in the environment <span class="tt wims_code_words">\begin{sol} ... \end{sol}</span>.
86		101
87	:credits	102	:credits
88	1	103	1
89	~~allow~~ to insert credits at the end of the exercise (variables are evaluated).	104	allows to insert credits at the end of the exercise (variables are evaluated).

Subversion Repositories wimsdev

(root)/trunk/wims/public_html/scripts/help/en/oefcommand – Rev 5903 → 8552