readthedocs/sphinx_rtd_theme

Add Sphinx 7 support

MehdiChinoune opened this issue · 15 comments

MehdiChinoune commented

Problem

Support sphinx>=7

Paebbels commented

Besides missing Sphinx 7 support, also Sphinx 6.1 isn't supported. This theme is still months behind the development of Sphinx and docutils.

This is related to:

Many documentation sites are currently switching to furo, because of better theme maintenance and better feature set.

  • 👍1
benjaoming commented

@Paebbels docutils 0.18 is supported and Sphinx 6.1 is also supported.

But agreed, there's also lack of maintenance for sphinx-rtd-theme. But the main reason is that the theme still hasn't reached the 2.0 roadmap milestone where a bunch of tedious legacy support is removed.

Paebbels commented

Hmmm, I get lots of errors when switching to Sphinx 6.1. I'll try to investigate, but debugging Sphinx is a mess as it has no good error messages and no (good) exception handling.

benjaoming commented

@Paebbels you can open an issue about Sphinx 6.1 support, sharing the error messages, and we can see if it's a real issue or not 👍

dyve commented 
ERROR: Cannot install -r docs/requirements.txt (line 2) and sphinx==7.0.1 because these package versions have conflicting dependencies.

The conflict is caused by:
    The user requested sphinx==7.0.1
    sphinx-rtd-theme 1.2.1 depends on sphinx<7 and >=1.6

To fix this you could try to:
1. loosen the range of package versions you've specified
2. remove package versions to allow pip attempt to solve the dependency conflict