# LaTeX support in Doxygen broken

XMLWordPrintable

#### Details

• Type: Story
• Status: Done
• Resolution: Done
• Fix Version/s: None
• Component/s:
• Labels:
None
• Story Points:
1
• Sprint:
Science Pipelines DM-S15-2
• Team:
Data Release Production

#### Description

LaTeX markup in Doxygen documentation ought to be rendered properly for display in HTML. It isn't: it's just dumped to the page as raw text. See, for example, the documentation for AffineTransform.

#### Activity

Hide
John Swinbank added a comment -

Doxgen can handle LaTeX by either rendering it to images and adding them to the HTML output, or by using MathJax. The default is the former; it is disabled if MathJax is enabled.

Our current configuration sets

 USE_MATHJAX = YES

thereby disabling the default LaTeX support. However, we also set

 MATHJAX_RELPATH = http://www.mathjax.org/mathjax

which causes Doxygen to look for MathJax at http://www.mathjax.org/mathjax/MathJax.js, which is a 404.

The correct MATHJAX_RELPATH is https://cdn.mathjax.org/mathjax/latest. Changing to that should fix the problem.

Show
John Swinbank added a comment - Doxgen can handle LaTeX by either rendering it to images and adding them to the HTML output, or by using MathJax. The default is the former; it is disabled if MathJax is enabled. Our current configuration sets USE_MATHJAX = YES thereby disabling the default LaTeX support. However, we also set MATHJAX_RELPATH = http://www.mathjax.org/mathjax which causes Doxygen to look for MathJax at http://www.mathjax.org/mathjax/MathJax.js , which is a 404. The correct MATHJAX_RELPATH is https://cdn.mathjax.org/mathjax/latest . Changing to that should fix the problem.

#### People

Assignee:
John Swinbank
Reporter:
John Swinbank
Watchers:
John Swinbank