Claude Warren created MATH-1510:
-----------------------------------
Summary: mathjax CDN shutting down
Key: MATH-1510
URL: https://issues.apache.org/jira/browse/MATH-1510
Project: Commons Math
Issue Type: Bug
Affects Versions: 3.6.1
Reporter: Claude Warren
This is the as https://issues.apache.org/jira/browse/NUMBERS-36 from which this
text is lifted. I noticed the issue in the site.xml file.
Javadoc for Commons Math, Commons Numbers and friends use a the
[MathJax|https://www.mathjax.org/] Javascript in order to render LaTeX equation
within Javadoc. (See MATH-1006)
This used to be included as
[http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML]
– but now [cdn.mathjax.org is shutting
down|https://www.mathjax.org/cdn-shutting-down/]. There is a temporary redirect.
There are several alternatives suggested, with the recommended being:
{code:java}
<script type="text/javascript" async
src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?...";>
</script>
{code}
Other alternatives include rawgit.com - e.g.
[https://cdn.rawgit.com/mathjax/MathJax/2.7.1/MathJax.js] with a fixed version
- which is probably a good thing. I've tried this approach for Commons Numbers,
which seems to work – not sure if adding {{?config=TeX-AMS-MML_HTMLorMML}}
would make any difference there as rawgit caches the file directly from GitHub.
Of course the MathJax javascript is Apache-licensed, so we could easily embed
it in the ASF source code - but then in multi-module projects I wonder if we
would then need to share it across all modules.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
