MathJax startup script.

[randolf-scholz]

Is it possible to configure mathjax3_config to add a startup script like described here?

[electric-coder]

I don't know, there aren't many posts giving examples on advanced MathJax usage with Sphinx on Stack Overflow. I wish more users were using MathJax+Sphinx and showing how to do it.

[AA-Turner]

@randolf-scholz The below is untested but should work:

# conf.py
mathjax3_config = ''

def setup(app):
   app.add_js_file('', body="""\
window.MathJax = {
  // whatever was previously in mathjax3_config

  startup: {
    ready() {
      //
      // Do usual setup
      //
      MathJax.startup.defaultReady();
      //
      // The pseudoscript numbers 0 through 9, and a pattern for plus-or-minus a number
      //
      const scripts = '\u2070\u00B9\u00B2\u00B3\u2074\u2075\u2076\u2077\u2078\u2079';
      const scriptRE = /([\u207A\u207B])?([\u2070\u00B9\u00B2\u00B3\u2074-\u2079]+)/g;
      //
      //  Add a TeX prefilter to convert pseudoscript numbers to actual superscripts
      //
      MathJax.startup.document.inputJax[0].preFilters.add((data) => {
        data.math.math = data.math.math.replace(scriptRE, (match, pm, n) => {
          const N = n.split('').map(c => scripts.indexOf(c));  // convert digits
          pm === '\u207A' && N.unshift('+');     // add plus, if given
          pm === '\u207B' && N.unshift('-');     // add minus, if given
          return '^{' + N.join('') + '}';        // make it an actual power
        });
      });
    }
  }
};
""")

A

[randolf-scholz]

And this is the js file https://github.com/randolf-scholz/linodenet/blob/fd43fc21a0b5807ab6b2a2c53890ebae3c5a69a4/docs/_static/mathjax_startup.js

[randolf-scholz]

@AA-Turner I got back to looking into this and figured out why this does not work. In the generated HTML, sphinx will put

<script>window.MathJax = { custom config } </script>
// [...]
<script>window.MathJax = {"options": {"processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>

and the later one overwrites the custom config. If I comment out the second one, the HTML renders as expected.

Is there a way to delay the addition of the custom script (app.connect maybe?)

[mgeier]

In the generated HTML, sphinx will put [..]

The "options" stuff is actually added by MyST-Parser, see https://github.com/executablebooks/MyST-Parser/blob/8a44f5d35197b19aab2f1fe35b6f1dce4960bce5/myst_parser/config/main.py#L424.

So you should probably ask the MyST folks how to disable this.

[randolf-scholz]

Disabling MyST does indeed solve this issue, but I guess they probably have a good reason to add this, so I wouldn't expect them removing it.

[randolf-scholz]

PR #14025 solves this without having to fiddle with 3rd party extensions.

[AA-Turner]

#14025 has been merged, adding a new mathjax_config_path option.

A