readthedocs.org: many older doc versions have broken JS

Details

Read the Docs project URL: https://django-reversion.readthedocs.io/en/release-1.8/

Expected Result

Clicking on the version selector down in the bottom left should work. It should pop up a selector that lets me pick a version of the docs.

Actual Result

Clicking on it doesn’t do anything and there’s an error in the console:

(index):383 Uncaught ReferenceError: SphinxRtdTheme is not defined
    at HTMLDocument.<anonymous> ((index):383)
    at f (jquery-2.0.3.min.js:23)
    at Object.fireWith [as resolveWith] (jquery-2.0.3.min.js:23)
    at Function.ready (jquery-2.0.3.min.js:22)
    at HTMLDocument.dt (jquery-2.0.3.min.js:22)
(anonymous) @ (index):383
f @ jquery-2.0.3.min.js:23
fireWith @ jquery-2.0.3.min.js:23
ready @ jquery-2.0.3.min.js:22
dt @ jquery-2.0.3.min.js:22
readthedocs-doc-embed.js:1
Applying theme sidebar fix...

This appears to happen on old versions of docs for multiple projects that I tried. Happy to provide a few more if it’s helpful. On https://django-reversion.readthedocs.io/en/latest/ the popup works correctly, but switching to one of the older versions breaks it.

About this issue

Original URL
State: closed
Created 3 years ago
Comments: 32 (29 by maintainers)

Most upvoted comments

@kuzmoyev haha, that makes it very easy for you to contribute to the project 💯 thanks for confirming that it works, I guess the former build from last week happened exactly before sphinx-rtd-theme 1.2.0 was released.

benjaoming on Feb 14, 2023

@kuzmoyev thanks for adding feedback here - this project is broken because it uses Sphinx 6.x and hasn’t upgraded to sphinx-rtd-theme 1.2.0. If you can contribute a fix to them, that’d be great 👍

benjaoming on Feb 14, 2023

I think we can close this issue since the problem is solved when enabling the new beta addons on the project. You can enable them by:

Opening https://beta.readthedocs.org
Going to the project’s admin page
Clicking on Addons (Beta)
Checking the check-box
Save

Screenshot:

Screenshot_2023-11-07_11-49-56

Feel free to enable the beta addons and let me know if that solves the problem on your projects. I’m happy to re-open the issue if this is not solved after enabling the beta addons. Eventually, the beta addons will be enabled by default in all the projects.

humitos on Nov 7, 2023

Thanks for the info. I’m the owner of the project. I don’t have a cap on the sphinx and sphinx-rtd-theme versions, but for some reason, the last build was with sphinx-rtd-theme=0.5.1. Hitting rebuild resolved the issue

kuzmoyev on Feb 14, 2023