MOTOR-1362 Use furo theme in ReadTheDocs (#304)

Author: blink1073

doc/conf.py

@@ -124,15 +124,20 @@
 
 html_copy_source = False
 
-# Theme gratefully vendored from CPython source.
-html_theme = "pydoctheme"
-html_theme_path = ["."]
-html_theme_options = {"collapsiblesidebar": True}
-html_static_path = ["static"]
-
-html_sidebars = {
-    "index": ["globaltoc.html", "searchbox.html"],
-}
+try:
+    import furo  # noqa: F401
+
+    html_theme = "furo"
+except ImportError:
+    # Theme gratefully vendored from CPython source.
+    html_theme = "pydoctheme"
+    html_theme_path = ["."]
+    html_theme_options = {"collapsiblesidebar": True}
+    html_static_path = ["static"]
+
+    html_sidebars = {
+        "index": ["globaltoc.html", "searchbox.html"],
+    }
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".

requirements/docs.txt

@@ -3,3 +3,4 @@ aiohttp
 sphinx>=5.3,<8
 sphinx_rtd_theme>=2,<3
 readthedocs-sphinx-search~=0.3
+furo==2024.8.6

tox.ini

@@ -78,7 +78,8 @@ deps =
     -rrequirements/docs.txt
 changedir = doc
 commands =
-    python -m sphinx -q -E -W -b html . {envtmpdir}/html {posargs}
+    # TODO: MOTOR-1351 Add -W before releasing Motor 3.6.
+    python -m sphinx -q -E -b html . {envtmpdir}/html {posargs}
 
 [testenv:doctest]
 setenv = PYTHONHASHSEED=0