devdoc build using the scipy-sphinx-theme-v2

[Shekharrajak]

Using the theme : https://github.com/Shekharrajak/scipy-sphinx-theme-v2
Related PR: numpy/numpy#14648

[rgommers]

There's a ton of SVG images for math expressions in this PR. I think you still have pngmath or imgmath in your config somewhere, it should be changed to using mathjax so we get rendered math in the browser rather than static images.

I don't think the rest of this PR is reviewable before that is fixed, it has 3000+ changed files.

[Shekharrajak]

I have removed plugins sphinx.ext.imgmath which were generating images in _image/math folder. I am using js directly here instead of sphinx plugin so they are not needed.

I have removed the build related hidden files as well.

[rgommers]

Ah the link above it moved, it's loaded directly in the html: scipy/scipy-sphinx-theme-v2@2f8cb2e

I suspect that this is the more correct way of doing it: https://github.com/scipy/scipy/blob/master/doc/source/conf.py#L44. I think mathjax config belongs in the config of the project using the theme, rather than hardcoded in the theme. The old Sphinx theme doesn't have anything.

This PR also still has thousands of .doctree files, do those need to be there?

[Shekharrajak]

Thanks @rgommers! I will try with plugin once again (last time I find some issue with generated the latex version for the equations, so I tried to add the JS in script itself).

[Shekharrajak]

Ah the link above it moved, it's loaded directly in the html: scipy/scipy-sphinx-theme-v2@2f8cb2e

I suspect that this is the more correct way of doing it: https://github.com/scipy/scipy/blob/master/doc/source/conf.py#L44. I think mathjax config belongs in the config of the project using the theme, rather than hardcoded in the theme. The old Sphinx theme doesn't have anything.

This PR also still has thousands of .doctree files, do those need to be there?

Fixed it here : scipy/scipy-sphinx-theme-v2#73

[mattip]

Closing. HEAD had moved to the pydata_sphinx_theme from Pandas.