Update MathJax URL

aherbert · aherbert · commit 42daa879e3e2 · 2025-02-18T14:35:24.000Z
MathJax is now hosted on Apache servers to comply with the Content
Security Policy (CSP) for project websites.
diff --git a/pom.xml b/pom.xml
@@ -118,6 +118,8 @@
     <commons.release.isDistModule>true</commons.release.isDistModule>
     <!-- project.build.outputTimestamp is managed by Maven plugins, see https://maven.apache.org/guides/mini/guide-reproducible-builds.html -->
     <project.build.outputTimestamp>2024-12-18T21:13:07Z</project.build.outputTimestamp>
+    <!-- MathJax configuration. See the maven-javadoc-plugin plugin. -->
+    <mathjax.url>https://commons.apache.org/js/mathjax/tex-mml-chtml.js</mathjax.url>
     <!-- JaCoCo: Don't make code coverage worse than: -->
     <commons.jacoco.haltOnFailure>true</commons.jacoco.haltOnFailure>
     <commons.jacoco.classRatio>0.96</commons.jacoco.classRatio>
@@ -127,7 +129,6 @@
     <commons.jacoco.lineRatio>0.85</commons.jacoco.lineRatio>
     <commons.jacoco.complexityRatio>0.78</commons.jacoco.complexityRatio>
     <doxia.module.markdown.version>2.0.0</doxia.module.markdown.version>
-    <math.mathjax.version>2.7.9</math.mathjax.version>
     <commons.easymock.version>5.5.0</commons.easymock.version>
     <!-- PMD 7.9.0 throws java.io.IOException: Stream closed probably because PMD is shadding ASM. -->
     <commons.pmd-impl.version>7.8.0</commons.pmd-impl.version>
@@ -223,14 +224,15 @@
         </configuration>
       </plugin>
       <plugin>
+        <!-- NOTE: javadoc config must also be set under <reporting> -->
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-javadoc-plugin</artifactId>
         <configuration>
-            <source>8</source>
-            <!-- TODO -->
-            <failOnWarnings>false</failOnWarnings>
-            <!-- Enable MathJax -->
-            <additionalOptions>-Xdoclint:all --allow-script-in-comments -header '&lt;script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/${math.mathjax.version}/MathJax.js?config=TeX-AMS-MML_HTMLorMML"&gt;&lt;/script&gt;'</additionalOptions>
+          <source>8</source>
+          <!-- TODO -->
+          <failOnWarnings>false</failOnWarnings>
+          <!-- Enable MathJax -->
+          <additionalOptions>-Xdoclint:all --allow-script-in-comments -header '&lt;script type="text/javascript" async src="${mathjax.url}"&gt;&lt;/script&gt;'</additionalOptions>
         </configuration>
       </plugin>
       <plugin>
@@ -315,6 +317,18 @@
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-pmd-plugin</artifactId>
       </plugin>
+      <plugin>
+        <!-- NOTE: javadoc config must also be set under <build> -->
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-javadoc-plugin</artifactId>
+        <configuration>
+          <source>8</source>
+          <!-- TODO -->
+          <failOnWarnings>false</failOnWarnings>
+          <!-- Enable MathJax -->
+          <additionalOptions>-Xdoclint:all --allow-script-in-comments -header '&lt;script type="text/javascript" async src="${mathjax.url}"&gt;&lt;/script&gt;'</additionalOptions>
+        </configuration>
+      </plugin>
     </plugins>
   </reporting>
   <profiles>
diff --git a/src/site/site.xml b/src/site/site.xml
@@ -23,7 +23,7 @@
     <image src="/images/logo.png"/>
   </bannerRight>
   <body>
-    <head>&lt;script type="text/javascript" id="MathJax-script" async="async" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-AMS-MML_HTMLorMML"&gt;&lt;/script&gt;
+    <head>&lt;script type="text/javascript" id="MathJax-script" async="async" src="https://commons.apache.org/js/mathjax/tex-mml-chtml.js"&gt;&lt;/script&gt;
         &lt;style&gt;
             .footnotes ol li p {
             display: inline;
