I rebuilt the site using the latest MathJax <script> tags. The site pages using MathJax now work:
https://home.apache.org/~aherbert/commons-numbers-1.1-RC1-site2/userguide/index.html#Continued_Fractions https://home.apache.org/~aherbert/commons-numbers-1.1-RC1-site2/developers.html Note: The site has been uploaded to a new directory (commons-numbers-1.1-RC1-site2) so you have to use these links and not the previous ones to view the fix. Alex On Sat, 29 Oct 2022 at 00:09, Bruno Kinoshita <ki...@apache.org> wrote: > Ah good spot Alex. I believe we can sort out these site issues after the > release if needed (in case the site is rendered correctly after the > release/deploy). > > Bruno > > On Sat, 29 Oct 2022, 9:55 am Alex Herbert, <aherb...@apache.org> wrote: > > > I included the wrong link to the changes report. It is here: > > > > > > > https://home.apache.org/~aherbert/commons-numbers-1.1-RC1-site/changes-report.html > > > > Note that this custom site is only required as the commons-release-plugin > > does not stage the multi-module site, so it is done manually for review. > > > > I note that there are two locations on the site using MathJax that are > not > > rendering correctly, particularly the user guide which uses it heavily > for > > some sections, e.g. > > > > > > > https://home.apache.org/~aherbert/commons-numbers-1.1-RC1-site/userguide/index.html#Continued_Fractions > > > > > https://home.apache.org/~aherbert/commons-numbers-1.1-RC1-site/developers.html > > (search for 'Pythagorean triplet') > > > > I do not know why this is happening. They render correctly locally using > > the same site I used for the upload. The javadocs using MathJax are > > rendered OK, e.g. > > > > > > > https://home.apache.org/~aherbert/commons-numbers-1.1-RC1-site/commons-numbers-docs/apidocs/org/apache/commons/numbers/gamma/IncompleteGamma.Lower.html > > > > The MathJax url for the javadoc and the site pages is different. Note > that > > the developers guide on the Numbers live site for the last release is > also > > broken for MathJax, so it may never have been working. The RNG site does > > work for the same page and so this can be fixed post-deployment. For now > > you can render the site locally to view the user guide: > > > > mvn site -DgenerateReports=false -N > > open target/site/userguide/index.html > > > > Alex > > >
