Re: MathJax support in texi2any

[Patrice Dumas]

On Wed, Oct 07, 2020 at 08:00:50PM +0100, Gavin Smith wrote:
> I've implemented basic MathJax support in texi2any in commit
> 7ff3cbdc4.

Should there be new @-environement commands for display math and 
equation ($$...$$ and \[...\] in Mathjax and Tex/LaTeX)?  If not, I guess 
that users will use @tex (possibly with LaTeX in @tex blocks) 
or custom @macros and still not use the now 'native' mathjax support.

I wanted to check the mathjax support for the singular manual for
example, which has maths written in LaTeX, but it uses @tex all over,
and not @math.


I propose to add a test with mathjax in tp/tests/layout/list-of-tests:
formatting_mathjax formatting.texi --html -c HTML_MATH=mathjax
Would that be ok?

The @math is rendered in that example correctly with mathjax.


3 remarks:

In _convert_math_command, the condition
  if (!defined($self->get_conf('L2H'))) {
will never be true.  Indeed, if L2H is set, latex2html.pm should be
loaded, in that file texinfo_register_command_formatting('math', ..) is 
called which means that Texinfo::Convert::HTML::_convert_math_command
will not be called.


I think that there should not be a warning if there is @math in a
document and HTML_MATH is not set.


Another remark, I think that the class that enables mathjax should be
specific and not 'math', as we may want, for example to have the math
class be added to @math element irrespective of mathjax being handled
or not.  For example, tex2jax_process could be used to be similar with 
tex2jax_ignore.

-- 
Pat