Using MathFlow in oXygen

The concept of a MathML-aware document type (doctype for short) is important to understand when authoring MathML documents in oXygen. Most of the components and script code that make up MathFlow integration with the oXygen editor do not depend on a specific document type, but your doctype must include MathML to be able to create and edit equations with MathFlow

There are several considerations in setting up a new math doctype, such as including the MathML 3.0 schema module in your custom schema. Although MathFlow has been designed to help minimize the amount of work required and in some cases setting a few configuration variables will suffice, in most instances much more customization will be needed. For complete details on setting up your own doctype, including discussion of the DTD (Document Type Definition), please refer to the Setting up a custom doctype section later in this documentation.

oXygen comes with a good many templates you can use choose from to create documents with math:

These can also be used as guidance when setting up MathFlow to work with custom doctypes. There are sample documents in the samples/docbook/v4 and docbook/v5 folders you can use to help familiarize yourself with MathFlow features.

In addition, oXygen includes a number of templates you can use to create MathML "documents", which essentially are stand-alone MathML equations:

To insert an equation, click the icon on the toolbar if it's there. It won't be there for all templates, so if it's not there, look in the template's menu for the Insert Equation command:

Since MathML is part of the DITA 1.3 spec, MathML is included by default, with no special action required on your part. You should be able to find the Insert Equation command in the Insert flyout of the DITA menu for any of the DITA templates available in oXygen 17.1 or later. This assumes, of course, the insertion point is located inside an element where MathML is allowed.