Re: tightening mathjax tex options

[Patrice Dumas]

On Fri, Sep 06, 2024 at 08:47:05AM -0700, Raymond Toy wrote:
> On 9/6/24 3:28 AM, Patrice Dumas wrote:
> 
> > Hello,
> > 
> > I propose to set the following in mathjax defaults, to avoid possible
> > interactions with text (although it may not be possible anyway because
> > of ignoreHtmlClass set in body), and perhaps simplifying the task of 
> > mathjax:
> > 
> >    tex: {
> >      processEscapes: false,      // use \$ to produce a literal dollar sign
> >      processEnvironments: false, // process \begin{xxx}...\end{xxx} outside 
> > math mode
> >      processRefs: false,         // process \ref{...} outside of math mode
> >      displayMath: [             // start/end delimiter pairs for display 
> > math
> >        ['\\[', '\\]']
> >      ],
> >    }
> > 
> > Any comment?
> What are the current values for these? I’m most worried that if these are
> different, you’ll break lots of existing uses. Maxima’s user manual
> <https://maxima.common-lisp.dev/docs/index.html> uses Mathjax a lot to get
> nice HTML display of math.

The change in settings may only affect LaTeX rendered by MathJax outside
of @math and @displaymath, using different structures as what is done in
texi2any.  This would be possible if you directly ouput HTML like

<span class="tex2jax_process">$$ \frac{a}{b} $$</span>

<p class="tex2jax_process">
some text
\begin{equation}
 f(h) = a^{b^c}
\end{equation}
<p>



Do you have a page which shows some math that are rendered by MathJax?



The defaults are:

    displayMath: [             // start/end delimiter pairs for display math
      ['$$', '$$'],
      ['\\[', '\\]']
    ],
    processEscapes: true,      // use \$ to produce a literal dollar sign
    processEnvironments: true, // process \begin{xxx}...\end{xxx} outside math 
mode
    processRefs: true,         // process \ref{...} outside of math mode


see
https://docs.mathjax.org/en/latest/options/input/tex.html#tex-options