Switch to Furo

- Bump dependencies & add Furo
- Drop a fair bit of theme configuration
- Fix the toctree declarations in index.rst

docs/conf.py

@@ -115,29 +115,8 @@ def make_pypi_svg(version: str) -> None:
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = "alabaster"
-
-html_sidebars = {
-    "**": [
-        "about.html",
-        "navigation.html",
-        "relations.html",
-        "searchbox.html",
-    ]
-}
-
-html_theme_options = {
-    "show_related": False,
-    "description": "“Any color you like.”",
-    "github_button": True,
-    "github_user": "psf",
-    "github_repo": "black",
-    "github_type": "star",
-    "show_powered_by": True,
-    "fixed_sidebar": True,
-    "logo": "logo2.png",
-}
-
+html_theme = "furo"
+html_logo = "_static/logo2-readme.png"
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,

docs/index.rst

@@ -99,6 +99,7 @@ Contents
 .. toctree::
    :maxdepth: 3
    :includehidden:
+   :caption: User Guide
 
    getting_started
    usage_and_configuration/index
@@ -109,17 +110,19 @@ Contents
 .. toctree::
    :maxdepth: 3
    :includehidden:
+   :caption: Development
 
    contributing/index
    change_log
    authors
 
 .. toctree::
    :hidden:
+   :caption: Project Links
 
-   GitHub ↪ <https://github.com/psf/black>
-   PyPI ↪ <https://pypi.org/project/black>
-   Chat ↪ <https://discord.gg/RtVdv86PrH>
+   GitHub <https://github.com/psf/black>
+   PyPI <https://pypi.org/project/black>
+   Chat <https://discord.gg/RtVdv86PrH>
 
 Indices and tables
 ==================

docs/requirements.txt

@@ -1,6 +1,7 @@
 # Used by ReadTheDocs; pinned requirements for stability.
 
-MyST-Parser==0.14.0
-Sphinx==3.5.4
+myst-parser==0.15.1
+Sphinx==4.1.1
 sphinxcontrib-programoutput==0.17
-sphinx_copybutton==0.3.1
+sphinx_copybutton==0.4.0
+furo==2021.7.5b38