[jira] [Created] (MATH-1510) mathjax CDN shutting down

["Claude Warren (Jira)" <ji...@apache.org>]

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)