[ https://issues.apache.org/jira/browse/NUMBERS36?page=com.atlassian.jira.plugin.system.issuetabpanels:commenttabpanel&focusedCommentId=16002456#comment16002456
]
Stian SoilandReyes commented on NUMBERS36:

I guess ideally the MathJax.js should be included, that means we don't rely on the thirdparty
CDN and avoid any firewall/security concerns for anyone else hosting the JavaDoc.
This seems to work across the modules:
{code:xml}
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>mavenjavadocplugin</artifactId>
<configuration>
<additionalparam>Xdoclint:all allowscriptincomments header '<script
type="text/javascript" src="{@docRoot}/resources/MathJax.js?config=TeXAMSMML_HTMLorMML"></script>'</additionalparam>
<! <aggregate>true</aggregate> >
<javadocDirectory>${numbers.parent.dir}/src/main/javadoc</javadocDirectory>
<docfilessubdirs>true</docfilessubdirs>
</configuration>
</plugin>
{code}
And then a single file {{src/main/javadoc/resources/MathJax.js}}
Agreed? It would have to be replaced from mathjax.org in{{src/main/javadoc}} when a new
MathJax is needed  but the CDN approach would also require version within URL to be updated.
Another advantage is that if then the javascript will also be embedded in the javadoc.jar
(note however that Eclipse don't render with Javascript)
> mathjax CDN shutting down  will soon break javadoc
> 
>
> Key: NUMBERS36
> URL: https://issues.apache.org/jira/browse/NUMBERS36
> Project: Commons Numbers
> Issue Type: Bug
> Reporter: Stian SoilandReyes
> Assignee: Stian SoilandReyes
>
> Javadoc for Commons Math, Commons Numbers and friends use a the [MathJaxhttps://www.mathjax.org/]
Javascript in order to render LaTeX equation within Javadoc. (See MATH1006)
> This used to be included as http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeXAMSMML_HTMLorMML
 but now [cdn.mathjax.org is shutting downhttps://www.mathjax.org/cdnshuttingdown/].
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=TeXAMSMML_HTMLorMML}} would
make any difference there as rawgit caches the file directly from GitHub.
> Of course the MathJax javascript is Apachelicensed, so we could easily embed it in the
ASF source code  but then in multimodule 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)
