Setting up a custom doctype for XMetaL

The sample DTD is located at this path:

<path-to-xmetal>\Author\[MF]\developer\author\journalist_math.dtd.

For journalist_math, the relevant lines are the following:

<!-- ============================================================= -->
<!--                         MATHML                                -->
<!-- ============================================================= -->
<!-- ===== UNCOMMENT THE FOLLOWING TO USE NAMESPACE PREFIXES =====
<!ENTITY % MATHML.prefixed "INCLUDE"> <!ENTITY % MATHML.prefix "mml"> -->
<!ENTITY % mathml-dtd PUBLIC "-//W3C//DTD MathML 3.0//EN" "mathml3.dtd">  %mathml-dtd;

Also, you need to define where MathML can be inserted, as in this example:

<!ENTITY % PhraseLevel "Citation | Emphasis | Strong |TT |
                        Underscore | InlineGraphic | Link |
                        Subscript | Superscript | ULink |
                        %MATHML.prefix;:math">

There are two steps necessary to customize your XML Schema:

<xs:import namespace="http://www.w3.org/1998/Math/MathML" schemaLocation="mathml3.xsd"/>

The sample customization file is located at this path:

<path-to-xmetal>\Author\[MF]\developer\author\journalist_math.ctm

First, the namespace prefix ("mml") needs to be defined. Under <DTDExtensions>, add the following element:

<NSPrefixMap>
<NSPrefixPair prefix="mml" ns="http://www.w3.org/1998/Math/MathML"></NSPrefixPair>
</NSPrefixMap>

Next, the MathML element (mml:math) needs to be defined. Under <ElementPropertiesList>, add the following element:

<ElementProperties>
    <Name ns="http://www.w3.org/1998/Math/MathML">mml:math</Name>
<LongDescription>Root MathML element</LongDescription>
    <PrettyPrintOptions>
        <NewLineBeforeStartTag/>
        <IndentContent/>
        <NewLineAfterEndTag/>
        <NewLineAfterStartTag/>
        <NewLineBeforeEndTag/>
    </PrettyPrintOptions>
</ElementProperties>

Note the MathML element (object) will end up showing as mml:mml:math in the ctm file.

Finally, the images of the MathML equation should be treated as type Image Element. The following attributes are used to position the image on the page: Height, Width, Valign (baseline). In addition, the Source (altimg) attribute identifies the path to the preview image for the equation. Under <Images>, add the following element:

<Image>
    <Name ns="http://www.w3.org/1998/Math/MathML">mml:math</Name>
    <Source-Attribute>altimg</Source-Attribute>
    <Height-Attribute>altimg-height</Height-Attribute>
    <Width-Attribute>altimg-width</Width-Attribute>
    <Valign-Attribute>altimg-baseline</Valign-Attribute>
</Image>

If the MathML namespace prefix for this custom doctype is not "mml" (the default prefix for MathFlow you will need to update the On_Document_First_Draw macro. Uncomment all of the lines (except the first line). Change the value of UPREFIX (on line 2) to your MathML namespace prefix. The rest of the lines, which set other global variables, do not need to be changed.

For example, if your MathML namespace prefix is "m", then your On_Document_First_Draw macro should look like this:

    // Set the MathML namespace prefix  UPREFIX = "m";
    MATHMLURI = " xmlns:"+UPREFIX+"=\"http://www.w3.org/1998/Math/MathML\"";
    if (UPREFIX!="") {
      PREFIX = UPREFIX+":";
    }
    MATH = PREFIX+"math";
    // Set the page width (in pixels) for this custom doctype for image generation
    PAGEWIDTH = -1;
    // -1 = default page width
    Application.Run("MF_On_Document_First_Draw");

If you use the labeled row in a table or matrix, then the appearance of the equation image generated will depend on the page width being used. In this case there is an additional global variable, PAGEWIDTH, which can be set. The default value of this variable is -1, which means use the default page width in the image generator (600 pixels). To specify a different page width for this custom doctype, set the PAGEWIDTH variable accordingly. For example, to change the page width to 800 pixels, you would change the On_Document_First_Draw macro as follows:

    // Set the page width (in pixels) for this custom doctype for image generation
    PAGEWIDTH = 800;

If the MathML namespace prefix for this custom doctype is not "mml" (the default prefix for MathFlow you will need to update the On_Macro_File_Load macro. Change the value of UPREFIX (on line 27) to your MathML namespace prefix. For example, if your MathML namespace prefix is "m", then line 27 in your On_Macro_File_Load macro should look like this :

    UPREFIX = "m";

The sample cascading stylesheet file is located at this path:

<path-to-xmetal>\Author\[MF]\developer\author\journalist_math.css.

An entry for the MathML element is entered as follows:

    mml:math
    {
    }

The sample HTML stylesheet file is located at this path:

<path-to-xmetal>\Author\[MF]\developer\author\journalist_math_HTML_Style.xsl.

An entry for the MathML element is entered as follows:

    <xsl:template match = "*[local-name() = 'math']" priority = "1000">
        <IMG SRC="{@altimg}" HEIGHT="{@altimg-height}" WIDTH="{@altimg-width}" ALT="" ALIGN="absmiddle" />
    </xsl:template>

The ALIGN can be changed to meet your requirements.