MathML support in Eclipse Oxygen 19.1 and Web

mu258770
Posts: 119

MathML support in Eclipse Oxygen 19.1 and Web

Tue Oct 30, 2018 11:46 am

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
Posts: 437

Re: MathML support in Eclipse Oxygen 19.1 and Web

Tue Oct 30, 2018 12:34 pm

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
Costin Sandoi
oXygen XML Editor and Author Support
mu258770
Posts: 119

Re: MathML support in Eclipse Oxygen 19.1 and Web

Wed Nov 14, 2018 12:55 pm

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
Posts: 5867

Re: MathML support in Eclipse Oxygen 19.1 and Web

Wed Nov 14, 2018 11:23 pm

Hi Shabeer,

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

https://www.oxygenxml.com/dita/1.3/specs/langRef/technicalContent/mathml.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/20.1/ug-editor/topics/mathjax-webhelp-x-modes2.html

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
mu258770
Posts: 119

Re: MathML support in Eclipse Oxygen 19.1 and Web

Thu Nov 15, 2018 7:35 am

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
Posts: 5867

Re: MathML support in Eclipse Oxygen 19.1 and Web

Thu Nov 15, 2018 10:37 am

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/20.1/ug-editor/topics/configure-mathflow-editor-x-modes2.html

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
mu258770
Posts: 119

Re: MathML support in Eclipse Oxygen 19.1 and Web

Thu Nov 15, 2018 1:15 pm

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
Posts: 5867

Re: MathML support in Eclipse Oxygen 19.1 and Web

Thu Nov 15, 2018 5:00 pm

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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
mu258770
Posts: 119

Re: MathML support in Eclipse Oxygen 19.1 and Web

Tue Nov 20, 2018 9:46 am

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
Posts: 5867

Re: MathML support in Eclipse Oxygen 19.1 and Web

Tue Nov 20, 2018 11:57 am

Hi Shabeer,

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

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
mu258770
Posts: 119

Re: MathML support in Eclipse Oxygen 19.1 and Web

Tue Nov 20, 2018 5:04 pm

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/20.1/ug-editor/topics/mathjax-webhelp-x-modes2.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
Posts: 5867

Re: MathML support in Eclipse Oxygen 19.1 and Web

Thu Nov 22, 2018 10:20 am

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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
mu258770
Posts: 119

Re: MathML support in Eclipse Oxygen 19.1 and Web

Thu Nov 22, 2018 1:05 pm

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
Posts: 5867

Re: MathML support in Eclipse Oxygen 19.1 and Web

Tue Nov 27, 2018 12:40 pm

Hi Shabeer,

I tried to create a sample plugin for you here:

https://github.com/raducoravu/dita-embed-mathml-imageref

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
mu258770
Posts: 119

Re: MathML support in Eclipse Oxygen 19.1 and Web

Wed Nov 28, 2018 3:36 pm

Hi Radu,

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

Regards,
Shabeer

Return to “DITA (Editing and Publishing DITA Content)”

Who is online

Users browsing this forum: No registered users and 2 guests