Documentation page

15 Jul 2010

Moodle Quiz Module allows you to define questionnaire-like activities in a course. A questionnaire consists of a set of questions, probably of different types. Read the information on moodle.org about this module if you are not familiar with it. From now on, Moodle basic terminology on questionnaires will be adopted.

WIRIS quizzes improves the types of questions in Moodle in order to add additional options aimed at posing strong maths questions. These options are displayed by clicking Show Advanced.

This manual offers a gradual and detailed view of WIRIS quizzes. It can be read linearly, or individual articles can be checked through the menu or through the following list:

9 Apr 2010

WIRIS Editor works with MathML but under some circumstances it modifies slightly the XML encoding.

This is done when the application that uses WIRIS editor does not allow inserting XML. For example, Moodle filters some HTML tags (APPLET, OBJECT, EMBED, etc.) and all unrecognized XML tags, and so it removes any MathML formula. This also occurs when the MathML appears inside an HTML attribute (for example, the SRC attribute of an IMG tag) and the browser, wrongly, tries to parse it.

In these situations, the 5 reserved characters of XML are replaced by other characters as shown in the following table:

Original XML characterReplacing character
< (#3C)« (#AB)
> (#3E)» (#BB)
& (#26)§ (#A7)
" (#22)¨ (#A8)
' (#27)´ (#B4)

For example,

Original XML fragmentReplaced XML fragment
<math xmlns="…">
  <msqrt>
     <mn>&pi;</mn>
  </msqrt>
</math>
«math xmlns=¨…¨»
  «msqrt»
    «mn»§pi; «/mn»
  «/msqrt»
«/math»

Then, recovering the MathML from the modified version is as simple as undoing the replacement. We provide as attached file an XSLT that does this replacement.

6 Apr 2010

Mathematical operations can be nested, and so symbols can contain expressions with symbols. Many symbols expand to match the size of their contents; note, for instance, the variable size of the square root symbol and the conjugation bar:

symbol matching

Normally we will also want our parentheses to scale depending on their contents, but this will not happen if we type them with the keyboard, since this will result in “normal” characters that do not scale, just as an “a” does not scale. If we want to use parentheses that do scale, we will have to use the , , and  icons in the General tab. By the way, this ensures that all couples of parenthesis are well closed and nested.

Let us see one example, by writing

«math xmlns=¨http://www.w3.org/1998/Math/MathML¨»«msup»«mfenced»«mrow»«mn»1«/mn»«mo»+«/mo»«mfrac»«mi»x«/mi»«mn»2«/mn»«/mfrac»«/mrow»«/mfenced»«mn»3«/mn»«/msup»«/math»

Write the base of the power
Select it
Click on the  icon
Select all of the parenthesis
Click on the  icon in the General tab
Click on the exponent and type 3
If instead of using the  icon we had used the ( and ) keys, the result would have been this:

If your formulae look a little bit odd, remember that, when several symbols are nested, there can be subtle differences depending on the exact order of nesting. For instance, consider «math xmlns=¨http://www.w3.org/1998/Math/MathML¨»«msub»«mover accent=¨true¨»«mi»x«/mi»«mo»§#8594;«/mo»«/mover»«mn»0«/mn»«/msub»«/math» and «math xmlns=¨http://www.w3.org/1998/Math/MathML¨»«mover accent=¨true¨»«msub»«mi»x«/mi»«mn»0«/mn»«/msub»«mo»§#8594;«/mo»«/mover»«/math»; the first is «math xmlns=¨http://www.w3.org/1998/Math/MathML¨»«mover accent=¨true¨»«mi»x«/mi»«mo»§#8594;«/mo»«/mover»«/math» “initialized”, while the second is «math xmlns=¨http://www.w3.org/1998/Math/MathML¨»«msub»«mi»x«/mi»«mn»0«/mn»«/msub»«/math» “vectorized”, so that the vector arrow extends over 0 only in the second case.

15 Mar 2010

It is possible to check whether the WIRIS cas server is running via a command line.

Type the following in the folder where the WIRIS cas is installed:

cd server
java Server --test-active

The return status of the above command will be 0 upon success and 1 when the server is not running or an error occurs.

You will get something like

[FINE:] Is Active check
[FINE:] host=localhost
[FINE:] port=31416
[FINE:] Opening socket...
[FINE:] Socket opened successfully.
[FINE:] Sending 'accept connections'...
[FINE:] Sent successfully.
[FINE:] Receiving...
[FINE:] Result received successfully.
[FINE:] Test performed successfully.

2 Jan 2010

1. The words must be complete except for well established math functions like: sin, cos, log, gcd, abs, etc. For example, polynomial (not polynom), factor (not fact), evaluate (not eval).

2. All names must be in lowercase because uppercase is reserved for types, which are internal and automatic in WIRIS.

3. No spaces or symbols other than _ are allowed in names. Apostrophes are not allowed.

4. Words must be correctly written with their accents.

5. Duplicated translations are forbidden (i.e. two different English words cannot map to the same translation). For this purpose, two different words due to their accents are considered the same word. For example, ángulo and angulo in Spanish.
There are two mutual-exclusive exceptions to this rule:

  • median_line and median can have the same translation (mediana in Spanish, médiane in French)
  • median_line and mean can have the same translation (mitjana in Catalan)