Skip to content
Embed referenced MathML and SVG images in the HTML5 and XHTML output
XSLT
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
com.oxygenxml.embed.mathml.svg
samples
CODE_OF_CONDUCT.md
CONTRIBUTING.md
LICENSE
README.md

README.md

dita-embed-html-mathml-svg

DITA Open Toolkit plugin which allows you to embed referenced MathML and SVG images in the HTML5 and XHTML output.

The plugin was tested using DITA Open Toolkit 3.2.1 and it aims to solve two use cases:

  1. When a DITA topic has an image reference to a MathML document, when publishing to HTML-based outputs in order to have the MathML content properly rendered in the Web Browser the reference to the MathML document needs to be expanded in-place in the HTML output. In web browsers other than Firefox the MathJax Javscript libraries also need to be referenced in the HTML document header: https://www.oxygenxml.com/doc/versions/20.1/ug-editor/topics/mathjax-webhelp-x-modes2.html

  2. When a DITA topic has an image reference to an SVG and the SVG document contains animation (custom Javascript code) in order for the animation to properly work in the web browser, the SVG needs to be referenced in the HTML document using the object HTML element. You need to set the @outputclass='embed' attribute on the DITA image reference in order to explicitly do this.

The "samples" folder contains a DITA topic with two referenced images (MathML and SVG) and can be used to test that the plugin works.

The plugin uses XSLT utility functions copied from the DITA Community plugins developed by Eliot Kimber: https://github.com/dita-community/org.dita-community.common.xslt

Copyright and License

Copyright 2019 Syncro Soft SRL.

This project is licensed under Apache License 2.0

You can’t perform that action at this time.