Stian Soiland-Reyes created NUMBERS-36:
------------------------------------------
Summary: mathjax CDN shutting down - will soon break javadoc
Key: NUMBERS-36
URL: https://issues.apache.org/jira/browse/NUMBERS-36
Project: Commons Numbers
Issue Type: Bug
Reporter: Stian Soiland-Reyes
Assignee: Stian Soiland-Reyes
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}
<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
(v6.3.15#6346)
