MathFlow Composer

$mathml::prefer_distiller = 1; in the mathml_user.acl file described in Customizing Editing.

For more information about the settings required for using Adobe Acrobat Distiller or Arbortext's Direct PDF, see the Configuring MathFlow Composer section of the installation guide.

Note you will have to modify the stylesheet you use so it recognizes MathML. See Setting up a Custom Doctype for some hints on how to do this.

If you are running Arbortext Editor in a non-Windows system, then the rendering of the equations in the PDF file is done via high-resolution PNG images. This means the quality of the rendering is limited, and there will be a noticeable deterioration when zooming in by large percentages. If the images are being displayed at much larger sizes, then set the environment variable APTPNGUSERES to "yes".

If you are running under Windows, then the quality of the equation rendering will be the same as the surrounding text. If you having problems with missing characters in MathFlow images, see MathFlow Composer (EPS) for information on how to configure font information.

If you have licensed HTML Composition, you have two choices for creating an HTML version of a MathML aware doctype from the Arbortext Editor - Save as HTML or Compose HTML file, both found on the Arbortext Editor File menu.

The Save as HTML menu command creates an HTML version of the document using the default stylesheet and encoding. Note if you choose to generate UMSS output (see below) you cannot use a Styler stylesheet. UMSS output should be an XML file, and a Styler stylesheet will always generate an HTML file when the Save as HTML command is selected. Therefore, a different XSL stylesheet should be associated with the document for HTML output, or chosen in the Publish HTML file dialog (used instead of Save as HTML).

When you choose the Save as HTML menu command, the following dialog will appear.

Equations panel

This panel lets you choose the kind of HTML file to generate. Which one to use is mostly a matter of what platforms you are targeting and ease of maintenance.

There are 3 different types of output to choose from:

Use images — This generates a page with JavaScript code and PNG images for displaying the equations. It uses higher resolution images for printing, and, if the MathZoom checkbox is checked, will pop up a larger image when you click on an equation image. This output is the most compatible, working basically in all the recent versions of the common browsers, without special plug-ins. On the other hand, it generates 7 images per equation, and uses an external mathpage.js file that needs to be in place for the page to be displayed correctly. Also, no MathML is actually written to the HTML file, so that information is lost.

MathML using — This writes MathML in the actual HTML file, and gives two further options:

• MathPlayer (IE6.0) writes a page configured to use our free MathPlayer plug-in for Microsoft's Internet Explorer browser. No extra files are needed. This works only on IE 6.0 or later, with the MathPlayer plug-in installed. Because this option is an outdated option, we recommend the next option…

• Multi-browser (UMSS) uses the Universal MathML Stylesheet so the page can be viewed in either IE (with MathPlayer plug-in) or Firefox (recent versions). Note in this case the file extension should be .xml, not .html, which may conflict with the original source file name. Requires the extra pmath.xsl stylesheet, IE 6.0 or later with MathPlayer plug-in, or Firefox.

In this case, you get the same dialog as with Save as HTML, but with an extra Stylesheet panel. Using this setting, you can choose which stylesheet and encoding to use for generating the HTML.

Note if you choose to generate UMSS output, you cannot use a Styler stylesheet. UMSS output should be an XML file, and a Styler stylesheet will always generate an HTML file when the Publish HTML file command is selected. Instead, use an XSL stylesheet for XML output, like the demo axdocbook_math-ev.xsl stylesheet.

Depending on the type of HTML output you choose, there may be extra files generated for the web page to display correctly.

Arbortext Publishing Engine (formerly Enterprise E-Content Engine (E3)) is a publishing server that automatically converts XML to multiple types of media—Web, print, PDF, HTML Help, wireless and more. MathFlow is seamlessly integrated with most of Publishing Engine's uses. However, since no interactive dialogs can be used from Publishing Engine, and since the output often involves many files, there are some special steps to take for using MathFlow with Publishing Engine's default 'convert' function when generating HTML.