MathML support in Eclipse Oxygen 19.1 and Web

[mu258770]

Hi team,

We would like to support MathML editing support in Eclipse Oxygen Author 19.1 and Web Oxygen Author 19.1 version.

Is there any built in editor in Eclipse Oxygen for it?
Or should we install it separately?
Is there any support for Web Oxygen Author 19.1?

Could you please answer the above.

Regards,
Shabeer

[Costin]

Hi Shabeer,

There is predefined support for MathML in oXygen, but that is more in a minimal form.
More specific, in the Author mode, you can insert equations, or double click a MathML equation to open the equation in a dedicated window that makes it possible to see adn edit the MathML elements.
This support is also available in Web Author.

More details about the MathML support and working with MathML in oXygen are available in the oXygen XML Autor Eclipse plugin User-Guide.

However, for comprehensive MathML support, you should use the MathFlow editor (which is a commercial, MathML specialized editor, available both for oXygen XML Author and for oXygen Web Author)

Regards,
Costin

[mu258770]

Hi Costin,

Thank you for the response!

I have one more query related to MathMl. In Oxygen documentation (https://www.oxygenxml.com/doc/versions/ ... athml.html), I have seen MathMl can be inserted as image. Could you please explain how that is possible? What should be the extension for the file for MathML? And is there any special attributes we need to mention when we insert the MathMl as image.

Regards,
Shabeer

[Radu]

Hi Shabeer,

You can either embed Mathml equations directly in the DITA content:

https://www.oxygenxml.com/dita/1.3/spec ... athml.html

or save the Mathml equation to a file called something like "imageFile.mml" and then refer to it using the regular DITA <image> element.
Both these ways should work in the PDF output.
For the Web based output you may need an extra Javascript library to get this to work:

https://www.oxygenxml.com/doc/versions/ ... odes2.html

Regards,
Radu

[mu258770]

Hi Radu,

Thanks a lot for the explanation:)

I have one more query though. Do we have an editor for .mml files for Windows? Some reference would be useful. I have done some searches in google and could not find much.

Regards,
Shabeer

[Radu]

Hi Shabeer,

Oxygen does not have a visual MathML equation editor. You will need to use the commercial MathFlow for this:

https://www.oxygenxml.com/doc/versions/ ... odes2.html

Regards,
Radu

[mu258770]

Hi Radu,

Thank you!

MathFlow we can use if we want to edit the MathML equations inline in Oxygen if it is inserted using <mathml> element. But when we insert it as an image (.mml) how we could edit it using MathFlow?

Is there a known tool for .mml files creation and editing ? It need not to be integrated with Oxygen. But in my Windows machine, if I want to create/edit a .mml file, how can I do that other than text editing?

Regards,
Shabeer

[Radu]

Hi Shabeer,

Double click on the image reference in the DITA topic and Oxygen will edit it with MathFlow (if you already installed it).
Or open the mathml image separately, switch to the Author editing mode and double click the image there.

Regards,
Radu

[mu258770]

Hi Radu,

Thank you very much for your quick responses!

We are looking for some alternatives also for ".mml" file editing. Do you have any known tool for Windows (not Oxygen integrated but standalone Windows tool) for ".mml" creation and editing. We could see some tools like MathMagic, but it does not save the image as ".mml" file.

Our intention is to create the .mml file separately in Windows and then insert that image into DITA topics. If you have any known tool, that would be good to know.

Regards,
Shabeer

[Radu]

Hi Shabeer,

I do not have a proposal for you, maybe you could google for such a tool.

Regards,
Radu

[mu258770]

Hi Radu,

Thank you!

We have inserted some sample ".mml" files to a DITA topic in Oxygen and converted it to PDF and HTML (from Oxygen Author 20.1). It works fine in PDF, but not in HTML. We have added the JavaScript reference mentioned in the URL https://www.oxygenxml.com/doc/versions/ ... odes2.html, but still the image is not rendered anything.

Could you please let us know how the HTML output can be supported for the ".mml" images. Is it that we would need some utility integrated to the DITA-OT to convert ".mml" file to some other known image formats?

Regards,
Shabeer

[Radu]

Hi Shabeer,

If your DITA topic refers to a MathML image (located in another file) and you want that properly rendered in the HTML I think you have two options:

1) A DITA OT HTML customization plugin which has an XSLT template matching all DITA images referring to MathML files, reads the MathML content from the external file and adds it directly to the generated HTML document (so it embeds the MathML equation directly in the HTML content).
2) A DITA OT HTML customization plugin which may use an external library to convert the MathML equation to SVG and then either leave in the generated HTML document a reference to the converted SVG file or again add the SVG content directly embedded in the HTML output. SVG is supported by any web browser without the need of extra Javascript code.

Regards,
Radu

[mu258770]

Hi Radu,

Thank you for the explanation!

Is there built in DITA-OT plugins for that, or do we need to invent it ?

Regards,
Shabeer

[Radu]

Hi Shabeer,

I tried to create a sample plugin for you here:

https://github.com/raducoravu/dita-embe ... l-imageref

Regards,
Radu

[mu258770]

Hi Radu,

Thanks a lot for the sample plugin I will check and let you know how it works

Regards,
Shabeer