# moodle/moodle mirrored from git://git.moodle.org/moodle.git

### Subversion checkout URL

You can clone with
or
.

moving towards XHTML compliance

1 parent d489ecf commit ed0e1a2ed0bebddc01f1ed4fad54092e80ca97ca koenr committed
4 lang/en/help/quiz/attempts.html
 @@ -1,6 +1,6 @@

Quiz attempts

-

Students may be allowed to have multiple attempts at a quiz. +

Students may be allowed to have multiple attempts at a quiz.

This can help make the process of taking the quiz more of - an educational activity rather than simply an assessment. + an educational activity rather than simply an assessment.

26 lang/en/help/quiz/calculated.html
 @@ -1,6 +1,6 @@

Calculated questions

Calculated questions offers a way to create individual numerical question by the use of wildcards that are substituted with individual values when the quiz is taken. -
Below is a shrunken view of the main editing page with some example inputs:
+
Below is a shrunken view of the main editing page with some example inputs:
@@ -44,24 +44,24 @@ -
+
In the question text input and "Correct Answer Formula" {a} and {b} can be seen. These and any other {name} can be used as a wildcard that is substituted by some value when the quiz is taken. Also, the correct answer is calculated when the quiz is submitted using the expression in "Correct Answer Formula", which is calculated as a numerical expression after the substitution of the wildcards. The possible wildcard values are set or generated on a later page in "editing wizard" for calculated questions... -
The example formula uses the operator +. Other accepted operators are -*/ and % where % is the modulo operator. It is also possible to use some PHP-style mathematical function. Among these there are 24 single-argument function:
+
The example formula uses the operator +. Other accepted operators are -*/ and % where % is the modulo operator. It is also possible to use some PHP-style mathematical function. Among these there are 24 single-argument function:
abs, acos, acosh, asin, asinh, atan, atanh, ceil, cos, cosh, deg2rad, exp, expm1, floor, log, log10, log1p, rad2deg, round, sin, sinh, sprt, tan, tanh -
and two two-argument functions
+
and two two-argument functions
atan2, pow -
and the functions min and max that can take two or more arguments. It is also possible to use the function pi that takes no arguments but do not forget the use the parentheses - the correct usage is pi(). Similary the other function must have their argument(s) within parentheses. Possible usage is for example sin({a}) + cos({b}) * 2. It should not be any problem to wrap functions within eachother like cos(deg2rad({a} + 90)) etc. -
More details on how to use these PHP-style functions can be found in the documentation at the PHP web site -

+

and the functions min and max that can take two or more arguments. It is also possible to use the function pi that takes no arguments but do not forget the use the parentheses - the correct usage is pi(). Similary the other function must have their argument(s) within parentheses. Possible usage is for example sin({a}) + cos({b}) * 2. It should not be any problem to wrap functions within eachother like cos(deg2rad({a} + 90)) etc. +
More details on how to use these PHP-style functions can be found in the documentation at the PHP web site +

As for numerical questions it is possible to allow a margin within which all responses are accepted as correct. The "Tolerance" field is used for this. However, there are three different types of tolerances. These are Relative, Nominal and Geometric. If we say that the correct answer at quiz time is calculated to 200 and the tolerance is set to 0.5 then the different tolerance types work like this: -

Relative: A tolerance interval is calculated by multiplying the correct answer with 0.5, ie in this case we get 100 so for this tolerance the correct response must be between 100 and 300. (200 ± 100)
+

Relative: A tolerance interval is calculated by multiplying the correct answer with 0.5, ie in this case we get 100 so for this tolerance the correct response must be between 100 and 300. (200 ± 100)
This is useful if the magnitude of the correct answer can differ greatly between different wildcard values. -

Nominal: This is the simpliest tolerance type but not very powerful. The correct response must be between 199.5 and 200.5 (200 ± 0.5)
+

Nominal: This is the simpliest tolerance type but not very powerful. The correct response must be between 199.5 and 200.5 (200 ± 0.5)
This tolerance type can be useful if the differences between different correct answers are small. -

Geometric: The upper limit of the tolerance interval is calculated as 200 + 0.5*200 and is the same as for the relative case. The lower limit is calculated as 200/(1 + 0.5). The correct response must then be between 133.33 and 300.
+

Geometric: The upper limit of the tolerance interval is calculated as 200 + 0.5*200 and is the same as for the relative case. The lower limit is calculated as 200/(1 + 0.5). The correct response must then be between 133.33 and 300.
This is useful for complex calculation that must have great tolerances where relative tolerances of 1 or more would be used for the upper limit but clearly not acceptable for the lower limit as it would make zero a correct answer for all cases. -

+

The field Significant Figures does only relate to how the correct answer should be presented in the review or the reports. Examples: If it is set to 3 then the correct answer 13.333 would be presented as 13.3; 1236 would be presented as 1240; 23 would be presented as 23.0 etc. -

+

The feedback field and the optional unit fields work just like they do for numerical questions. -
+
2  lang/en/help/quiz/export.html
 @@ -1,7 +1,7 @@

Exporting questions from a Category

This function allows you to export a complete category of questions to - a text file. + a text file.

Please note that in many file formats some information is lost when the questions are exported. This is because many formats do

 @@ -42,7 +42,7 @@ Two plus two equals {=four =4}.

If there is only one correct Short Answer, it may be written without the equal sign prefix, - as long as it cannot be confused as True-False. + as long as it cannot be confused as True-False.

True-False:
In this question-type the answer indicates whether the statement is true or false.

 @@ -2,24 +2,24 @@

When multiple attempts are allowed, there are different ways you can use the grades to calculate the student's final - grade for the quiz. + grade for the quiz.

-

The final grade is the highest (best) grade in any attempt. +

-

The final grade is the average (simple mean) grade of all attempts. +

The final grade is the average (simple mean) grade of all attempts.

-

The final grade is the grade gained on the first attempt (other attempts are ignored). +

The final grade is the grade gained on the first attempt (other attempts are ignored).

-

The final grade is the grade gained on the most recent attempt only. +

The final grade is the grade gained on the most recent attempt only.

15 lang/en/help/quiz/import.html
 @@ -1,9 +1,9 @@

Importing new questions

This function allows you to import questions from - external text files, uploaded through a form. + external text files, uploaded through a form.

-

A number of file formats are supported: +

A number of file formats are supported:

@@ -49,7 +49,7 @@

This format only supports multiple choice questions. Each answer is separated with a tilde (~), and the correct answer is -prefixed with an equals sign (=). Here is an example: +prefixed with an equals sign (=). Here is an example:

As soon as we begin to explore our body parts as infants we become students of {=anatomy and physiology ~reflexology @@ -66,7 +66,7 @@ the questions all Short-Answer questions are converted four at a time into Matching Questions.

Additionally, the answers of multiple-choice questions are randomly - shuffled during the import. + shuffled during the import.

It's named after an organisation that sponsored the development of many quiz features

@@ -97,7 +97,8 @@

On Windows it lets you upload the access database just like any other data import file.

On Linux, you must set up a windows machine on the same network with the Course Test Manager database and a piece of software called the ODBC Socket Server, which uses XML -to transfer data to moodle on the Linux server.

Please read the full help file below before +to transfer data to moodle on the Linux server.

+

Please read the full help file below before using this import class.

@@ -120,10 +121,10 @@

Custom

If you have your own format that you need to import, you can - implement it yourself by editing mod/quiz/format/custom.php + implement it yourself by editing mod/quiz/format/custom.php

The amount of new code needed is quite small - just enough - to parse a single question from given text. + to parse a single question from given text.

62 lang/en/help/quiz/index.html
 @@ -1,35 +1,35 @@

Quizzes

6 lang/en/help/quiz/match.html
 @@ -2,10 +2,10 @@

After an optional introduction, the respondent is presented with several sub-questions and several jumbled answers. There is one - correct answer for each question. + correct answer for each question.

-

The respondent must select an answer to match each sub-question. +

The respondent must select an answer to match each sub-question.

Each sub-question is equally weighted to contribute towards the - grade for the total question. + grade for the total question.

 @@ -1,11 +1,11 @@

The maximum grade you set for a quiz is what all grades - are scaled to. + are scaled to.

For example, you might set the max grade to 20, because the - quiz is worth 20% of the whole course. + quiz is worth 20% of the whole course.

Even though you might have 10 questions in your quiz worth a total of 50 marks, all grades out of 50 will be - "scaled down" to the quiz max grade of 20. + "scaled down" to the quiz max grade of 20.

2  lang/en/help/quiz/mods.html
 @@ -1,4 +1,4 @@ -

Quizzes

+

Quizzes

This module allows the teacher to design and set quiz tests, consisting of multiple choice, true-false, and short answer questions. These

 @@ -1,17 +1,17 @@

This very flexible question type is similar to a - popular format known as the Cloze format. + popular format known as the Cloze format.

Questions consist of a passage of text (in Moodle format) that has various answers embedded within it, including multiple choice, - short answers and numerical answers. + short answers and numerical answers.

There is currently no graphical interface to create these questions - you need to specify the question format using the text box or by - importing them from external files. + importing them from external files.

-

Here is an example of the input text used to specify such a question: +

Here is an example of the input text used to specify such a question:

@@ -30,12 +30,12 @@ -

3

8 Marks

-

This question consists of some text with an answer embedded right here and right after that you will have to deal with this short answer and finally we have a floating point number .
+

3

8 Marks

+

This question consists of some text with an answer embedded right here and right after that you will have to deal with this short answer and finally we have a floating point number .

-Note that addresses like www.moodle.org and smileys all work as normal:
+Note that addresses like www.moodle.org and smileys all work as normal:
a) How good is this?

6 lang/en/help/quiz/multichoice.html
 @@ -2,16 +2,16 @@

In response to a question (that may include a image) the respondent chooses from multiple answers. There are two types of multiple choice - questions - single answer and multiple answer. + questions - single answer and multiple answer.

Single-answer questions allow one and only one answer to be chosen. - Generally all the grades for such a question should be positive. + Generally all the grades for such a question should be positive.

Multiple-answer questions allow one or more answers to be chosen - each answer may carry a positive or negative grade, so that choosing ALL the options will not necessarily result in good grade. If the total grade is negative then the total grade for this question will be zero. Careful, it is - possible to create questions that have scores greater than 100%. + possible to create questions that have scores greater than 100%.

Finally, each answer (right or wrong) should include feedback - this feedback will be shown to the respondent next to each of their answers (if the quiz

2  lang/en/help/quiz/questiondatasets.html
 @@ -9,7 +9,7 @@ questions within a category.

When creating a question that uses datasets, you'll be prompted - with two screens. + with two screens.

The first screen allows you to assign a particular dataset to be substituted for each variable.

2  lang/en/help/quiz/questiontypes.html
 @@ -6,7 +6,7 @@

In response to a question (that may include a image) the respondent chooses from multiple answers. There are two types of multiple choice - questions - single answer and multiple answer. + questions - single answer and multiple answer.

8 lang/en/help/quiz/randomsamatch.html
 @@ -2,13 +2,13 @@

After an optional introduction, the respondent is presented with several sub-questions and several jumbled answers. There is one - correct answer for each question. + correct answer for each question.

-

The respondent must select an answer to match each sub-question. +

The respondent must select an answer to match each sub-question.

Each sub-question is equally weighted to contibute towards the - grade for the total question. + grade for the total question.

The questions and answers are randomly drawn from the pool of "Short Answer" questions in the current category. Each attempt - on a quiz will have different questions and answers. + on a quiz will have different questions and answers.

2  lang/en/help/quiz/repeatattempts.html
 @@ -2,4 +2,4 @@

If multiple attempts are allowed and this setting is set to Yes, then each new attempt contains the results of the previous attempt. This allows a quiz to be completed over several attempts.

-

To show a fresh quiz on every attempt, select No for this setting. +

To show a fresh quiz on every attempt, select No for this setting.

 @@ -1,15 +1,15 @@

In response to a question (that may include a image) the respondent - types a word or short phrase. + types a word or short phrase.

There may be several possible correct answers, each with a different grade. If the "Case sensitive" option is selected, then you can - have different scores for "Word" or "word". + have different scores for "Word" or "word".

You can use the asterix character (*) as a wildcard to match any series of characters. For example, use ran*ing to match any word or phrase starting with "ran" and ending with "ing". If you really - do want to match an asterisk then use a backslash like this: \* + do want to match an asterisk then use a backslash like this: \*

-

Without wildcards the answers are compared exactly, so be careful with your spelling! +

Without wildcards the answers are compared exactly, so be careful with your spelling!

2  lang/en/help/quiz/timelimit.html
 @@ -1,7 +1,7 @@

Time limit

By default, quizzes do not have a time limit, which allows - students as much time as they need to complete the quiz. + students as much time as they need to complete the quiz.

If you do specify a time limit, the several things are done to try and ensure that quizzes are completed within that time:

4 lang/en/help/quiz/timeopen.html
 @@ -1,5 +1,5 @@

Opening and closing the quiz

-

You can specify times when the quiz is accessible for people to make attempts. +

You can specify times when the quiz is accessible for people to make attempts.

-

Before the opening time, and after the closing time, the quiz will be unavailable. +

Before the opening time, and after the closing time, the quiz will be unavailable.

2  lang/en/help/quiz/truefalse.html
 @@ -2,7 +2,7 @@

In response to a question (that may include a image) the respondent - chooses from True or False. + chooses from True or False.

If feedback is enabled, then the appropriate feedback message is shown to the respondent after answering the quiz. For example,

4 lang/en/help/resource/index.html
 @@ -9,6 +9,6 @@
• Directory
• Label
• -
• Parameters -
• Window settings +
• Parameters
• +
• Window settings
• 2  lang/en/help/resource/mods.html
 @@ -1,4 +1,4 @@ -

Resources

+

Resources

Resources are content: information the teacher wants to bring into the course. These can be prepared files uploaded to the course

2  lang/en/help/resource/window.html
 @@ -42,7 +42,7 @@ Show the status bar?

Showing the Status bar allows people to monitor browser information like how much of a resource has been loaded, or security information.

- +
• Determine the size window you wish to open.