MathML Equations in HTML Output

Currently, only Firefox can render MathML equations embedded in the HTML code. MathJax is a solution to properly view MathML equations embedded in HTML content in a variety of browsers.

If you have DocBook or DITA content that has embedded MathML equations and you want to properly view the equations in published HTML output types (WebHelp, CHM, EPUB, etc.), you need to add a reference to the MathJax script in the head element of all HTML files that have the equation embedded.

For example:

<script type="text/javascript" 
  src="http://cdn.mathjax.org/mathjax/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
</script>

For DITA documents, you can also use the following procedure:

  1. Edit the DITA Map WebHelp transformation scenario and open the Parameters tab.
  2. Set the following parameter to point to an XML resource file that contains your script, depending on your type of WebHelp system.
    • WebHelp Responsive Systems - Set the webhelp.fragment.head parameter to point to your resource file.
    • WebHelp Classic Systems - Set the webhelp.head.script parameter to point to your resource file.
  3. Run the transformation scenario.

Result: The equation should now be properly rendered in other browsers, such as Edge, IE, or Chrome.

Was this helpful?