Sphinx 7.2 breaks previously-working MathJax ?config=

[AA-Turner]

Describe the bug

NumPy removed the ?config=scipy-mathjax from their mathjax_path in numpy/numpy#24516, as Sphinx (intentionally) errored with Local asset file paths must not contain query strings. This broke MathJax rendering, as reported in numpy/numpy#24534.

Sphinx provides the mathjax2_config and mathjax3_config variables to provide configuration, but these aren't used by NumPy.

MathJax 3 moved away from the ?config= variable (reference), but NumPy/SciPy still use MathJax 2.7.1, with their versions last updated in 2017.

I'm tempted to special-case MathJax.js here to avoid the error.

How to Reproduce

Download and unzip https://github.com/scipy/scipy-mathjax into _static/scipy-mathjax.

extensions = ['sphinx.ext.mathjax']
mathjax_path = "scipy-mathjax/MathJax.js?config=scipy-mathjax"
html_static_path = ['_static']

Maths
-----

Here's some maths:

.. math::
    T_n(x) = \\frac{z^n + z^{-n}}{2} \\\\
    z\\frac{dx}{dz} = \\frac{z - z^{-1}}{2}.

and some more:

.. math:: x = \\frac{z + z^{-1}}{2}.

Environment Information

Sphinx 7.2.4

Sphinx extensions

``['sphinx.ext.mathjax']``

Additional context

• DOC: unpin sphinx  numpy/numpy#24516
• DOC: Mathematical formulas are not rendered numpy/numpy#24534
• DOC: re-pin sphinx<7.2 numpy/numpy#24543
• https://github.com/scipy/scipy-mathjax

cc: @mattip -- do you know if there are any plans for NumPy/SciPy to update to MathJax 3?

A

[AA-Turner]

I've proposed two potential fixes in #11659.