commons-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Stian Soiland-Reyes (JIRA)" <j...@apache.org>
Subject [jira] [Created] (NUMBERS-36) mathjax CDN shutting down - will soon break javadoc
Date Tue, 09 May 2017 08:59:04 GMT
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)

Mime
View raw message