Math not rendering in docs
Closed this issue · 7 comments
Looks like https://docs.arbor-sim.org/en/latest/concepts/lif_cell.html#lifcell isn't rendering the math
This seems to be a global problem and even occurs in local builds of the docs. Investigating...
It seems that the URLs for the embedded JS are off. In particular, opening the dev console turns up a series
of errors like this:
GET | https://docs.arbor-sim.org/en/latest/concepts/_JavaScript('/_/static/javascript/readthedocs-doc-embed.js',%20priority=500,%20async='async') 404
In particular there seems to be blocking due to strict MIME type checking.
The RTD search also seems broken, do you notice problems as well? Mine doesn't load any results any more
The only thing I could find is this:
https://stackoverflow.com/questions/68709496/searching-takes-forever-on-readthedocs-when-the-phrase-is-not-present-on-th
which has some of the same symptoms as we observe. The fix was to bump sphinx-rtd-theme
.
Our current theme is a patched and hardcoded version of divio
that @brenthuisman added two years back.
So, we might be forced to bump this.
Indeed, switching to a different theme fixes both problems.
The furo
theme is pretty nice https://github.com/pradyunsg/furo
Guess which one I switched to.