Fixes for Sphinx 8

Author: jacobtomlinson

.gitignore

@@ -137,3 +137,4 @@ ci/slurm/environment.yml
 ci/pbs/environment.yml
 ci/sge/environment.yml
 ci/htcondor/environment.yml
+docs/generated/

docs/requirements-docs.txt

@@ -1,15 +1,6 @@
 distributed
 numpydoc
 ipython
-sphinx<5
+sphinx>=8
 sphinx-reredirects
 dask-sphinx-theme>=3.0.0
-# FIXME: This workaround is required until we have sphinx>=5, as enabled by
-#        dask-sphinx-theme no longer pinning sphinx-book-theme==0.2.0. This is
-#        tracked in https://github.com/dask/dask-sphinx-theme/issues/68.
-#
-sphinxcontrib-applehelp<1.0.5
-sphinxcontrib-devhelp<1.0.6
-sphinxcontrib-htmlhelp<2.0.5
-sphinxcontrib-serializinghtml<1.1.10
-sphinxcontrib-qthelp<1.0.7

docs/source/conf.py

@@ -40,7 +40,6 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ["sphinx.ext.autodoc", "sphinx.ext.intersphinx", "sphinx.ext.mathjax"]
 extensions = [
     "sphinx.ext.autodoc",
     "sphinx.ext.mathjax",
@@ -210,6 +209,6 @@
 # Link to GitHub issues and pull requests using :pr:`1234` and :issue:`1234`
 # syntax
 extlinks = {
-    "issue": ("https://github.com/dask/dask-jobqueue/issues/%s", "GH#"),
-    "pr": ("https://github.com/dask/dask-jobqueue/pull/%s", "GH#"),
+    "issue": ("https://github.com/dask/dask-jobqueue/issues/%s", "GH#%s"),
+    "pr": ("https://github.com/dask/dask-jobqueue/pull/%s", "GH#%s"),
 }