Fix CI (#92)

.readthedocs.yaml

@@ -4,13 +4,16 @@ build:
   os: ubuntu-20.04
   tools:
     python: "3.9"
+  jobs:
+    post_install:
+      - pip install -r docs/requirements.txt
 
 sphinx:
   configuration: docs/conf.py
   fail_on_warning: true
 
 python:
   install:
-    - requirements: requirements.txt
+    - requirements: docs/requirements.txt
     - method: pip
       path: .

dask_sphinx_theme/ext/dask_config_sphinx_ext.py

@@ -83,7 +83,7 @@ def dask_config_to_html(key, value, schema, prefix=""):
                     <dd><p>{description}</p></dd>
                     </dl>
 
-                """
+                """  # noqa
         return [node]
 
 

docs/requirements.txt

@@ -0,0 +1,7 @@
+# FIXME: `sphinxcontrib-*` pins are a workaround until we have sphinx>=5.
+#        See https://github.com/dask/dask-sphinx-theme/issues/68.
+sphinxcontrib-applehelp>=1.0.0,<1.0.7
+sphinxcontrib-devhelp>=1.0.0,<1.0.6
+sphinxcontrib-htmlhelp>=2.0.0,<2.0.5
+sphinxcontrib-serializinghtml>=1.1.0,<1.1.10
+sphinxcontrib-qthelp>=1.0.0,<1.0.7