Uploaded image for project: 'Commons Numbers'
  1. Commons Numbers
  2. NUMBERS-36

mathjax CDN shutting down - will soon break javadoc

    XMLWordPrintableJSON

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: 1.0-beta1
    • Component/s: None
    • Labels:
      None

      Description

      Javadoc for Commons Math, Commons Numbers and friends use a the MathJax 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. There is a temporary redirect.

      There are several alternatives suggested, with the recommended being:

      <script type="text/javascript" async
        src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?...">
      </script>
      

      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.

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                stain Stian Soiland-Reyes
                Reporter:
                stain Stian Soiland-Reyes
              • Votes:
                0 Vote for this issue
                Watchers:
                2 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: