B. Contents of the "MathML support" add-on

The "MathML support" add-on contains:

  1. A configuration which allows to create standalone documents conforming to the MathML 2 schema[8] (presentation markup only, content markup is not supported).

    Such standalone documents are typically used the way graphics files are. XHTML example: <img src="equations/equation1.mml"/>.

    Note that this configuration adds not only a MathML menu to the GUI, but also a MathML tool just below the Edit tool, at the top/right of the main window.

  2. Additional configuration elements for the DocBook 5 configuration (found in mathml_addon_install_dir/docbook5/mathml_support.incl). These additional configuration elements allows to edit MathML elements embedded in DocBook 5 documents (by the means of elements such as imagedata, equation, inlineequation, etc).

    These additional configuration elements also add "Insert MathML Character By Name" and "Parse Text As MathML" items to the DocBook menu and extend the table editing commands in order to support the mml:mtable element and its descendants.

    A sample DocBook 5 document containing math is found in mathml_addon_install_dir/docbook5/sample.xml.

  3. Additional configuration elements for the DITA Topic configuration (found in mathml_addon_install_dir/dita/mathml_support.incl).

    These additional configuration elements add the same facilities as the above DocBook 5 customization.

    A sample DITA Topic document containing math is found in mathml_addon_install_dir/dita/sample.dita.

  4. Additional configuration elements for the XHTML 5 configuration (found in mathml_addon_install_dir/xhtml5/mathml_support.incl).

    These additional configuration elements add the same facilities as the above DocBook 5 customization.

    A sample XHTML 5 page containing math is found in mathml_addon_install_dir/xhtml5/sample.xhtml.

  5. An image toolkit similar to the one based on JEuclid.

    Note that installing this add-on also requires installing the add-on called "JEuclid image toolkit plug-in". That gives us two image toolkits which allow to convert MathML to a variety of graphics formats:

    • The ``internal'' image toolkit is needed to render the contents of the MathML tool[9].

    • The JEuclid image toolkit is used when XML documents embedding MathML or referencing MathML files are converted to formats such as HTML, PDF, RTF, etc. The JEuclid image toolkit is especially useful when the "Apache FOP 1.x XSL-FO processor plug-in" add-on has been also installed because it adds “native MathML support” to the Apache FOP XSL-FO processor.



[8] Opening a document starting with:

<!DOCTYPE math PUBLIC "-//W3C//DTD MathML 2.0//EN"
"http://www.w3.org/Math/DTD/mathml2/mathml2.dtd">

will of course cause the DTD to be used instead of the W3C XML Schema.

[9] Yes, just the contents of the MathML tool!