documentation on readthedocs fails to show rendered LaTeX

[parmentelat]

I would have expected the captions on the attached screenshot to be rendered as equations

[jasongrout]

@SylvainCorlay - do you know what is going on there?

[SylvainCorlay]

Nope, but it seems specific to RTD. The problem does not occur on nbviewer: http://nbviewer.jupyter.org/github/ipython/ipywidgets/blob/master/docs/source/examples/Widget%20Styling.ipynb

[SylvainCorlay]

MathJax is loaded on the page and typeset is called correctly

[jasongrout]

By the way, here is the link for the original issue: http://ipywidgets.readthedocs.io/en/latest/examples/Widget%20Styling.html#Latex

[jasongrout]

Looks to me like the issue is that RTD mathjax is configured with the default tex inline delimiters \( and \), while the notebook and nbviewer also have $. We should either change our example in the docs to \( and \), or fix our theme in RTD.

[jasongrout]

fix our theme in RTD.

(Preferably this, since there are many notebooks that have $ delimiters)

[jasongrout]

This should be fixed in #1363 - we'll wait until rtd updates to make sure.

[jasongrout]

It appears that $x^2$ is still not recognized, but $$x^2$$ is. We'll need to fix that in the jupyter-alabaster theme, maybe.

[jasongrout]

Actually, it looks like it's a setting in the mathjax sphinx extension, but not documented: https://github.com/sphinx-doc/sphinx/blob/0008d576fc82e196c8b7d3c82b7718ffb11b605d/sphinx/ext/mathjax.py#L79

[jasongrout]

Never mind, that config option seems to be for math written in the docs (it wraps with those delimiters), not for configuring mathjax. It seems like there's not a way to adjust the mathjax config easily, so I'll just change the actual docs themselves.