Page 1 of 1

MathML support in Eclipse Oxygen 19.1 and Web

Posted: Tue Oct 30, 2018 11:46 am
by 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

Re: MathML support in Eclipse Oxygen 19.1 and Web

Posted: Tue Oct 30, 2018 12:34 pm
by 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

Re: MathML support in Eclipse Oxygen 19.1 and Web

Posted: Wed Nov 14, 2018 12:55 pm
by 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

Re: MathML support in Eclipse Oxygen 19.1 and Web

Posted: Wed Nov 14, 2018 11:23 pm
by 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

Re: MathML support in Eclipse Oxygen 19.1 and Web

Posted: Thu Nov 15, 2018 7:35 am
by 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

Re: MathML support in Eclipse Oxygen 19.1 and Web

Posted: Thu Nov 15, 2018 10:37 am
by 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

Re: MathML support in Eclipse Oxygen 19.1 and Web

Posted: Thu Nov 15, 2018 1:15 pm
by 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

Re: MathML support in Eclipse Oxygen 19.1 and Web

Posted: Thu Nov 15, 2018 5:00 pm
by 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

Re: MathML support in Eclipse Oxygen 19.1 and Web

Posted: Tue Nov 20, 2018 9:46 am
by 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

Re: MathML support in Eclipse Oxygen 19.1 and Web

Posted: Tue Nov 20, 2018 11:57 am
by Radu
Hi Shabeer,

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

Regards,
Radu

Re: MathML support in Eclipse Oxygen 19.1 and Web

Posted: Tue Nov 20, 2018 5:04 pm
by 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

Re: MathML support in Eclipse Oxygen 19.1 and Web

Posted: Thu Nov 22, 2018 10:20 am
by 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

Re: MathML support in Eclipse Oxygen 19.1 and Web

Posted: Thu Nov 22, 2018 1:05 pm
by 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

Re: MathML support in Eclipse Oxygen 19.1 and Web

Posted: Tue Nov 27, 2018 12:40 pm
by Radu
Hi Shabeer,

I tried to create a sample plugin for you here:

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

Regards,
Radu

Re: MathML support in Eclipse Oxygen 19.1 and Web

Posted: Wed Nov 28, 2018 3:36 pm
by mu258770
Hi Radu,

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

Regards,
Shabeer