Switch docs to sphinx-book-theme

The only reason is because MyST figure captions vanished and I have no
time to investigate

Author: hynek

README.md

@@ -31,7 +31,7 @@ Thanks to its flexible design, *you* choose whether you want *structlog* to take
 
 The output format is just as flexible and *structlog* comes with support for JSON, [*logfmt*](https://brandur.org/logfmt), as well as pretty console output out-of-the-box:
 
-[![image](https://github.com/hynek/structlog/blob/main/docs/_static/console_renderer.png?raw=true)](https://github.com/hynek/structlog/blob/main/docs/_static/console_renderer.png?raw=true)
+[![Screenshot of colorful structlog output with ConsoleRenderer](https://github.com/hynek/structlog/blob/main/docs/_static/console_renderer.png?raw=true)](https://github.com/hynek/structlog/blob/main/docs/_static/console_renderer.png?raw=true)
 
 
 ## Sponsors

docs/_static/custom.css

@@ -3,18 +3,8 @@
 
 
 :root {
-  font-feature-settings: 'liga' 1, 'calt' 1;
-  /* fix for Chrome */
-}
-
-@supports (font-variation-settings: normal) {
-  :root {
-    font-family: 'Atkinson Hyperlegible', sans-serif;
-  }
-}
-
-
-/* Hide ToC caption text within the main body (but leave them in the side-bar). */
-#furo-main-content span.caption-text {
-  display: none;
+  font-feature-settings: 'liga' 1, 'calt' 1;  /* fix for Chrome */
+  --pst-font-family-base: "Atkinson Hyperlegible", system-ui, sans-serif;
+  --pst-font-family-heading: "Atkinson Hyperlegible", system-ui, sans-serif;
+  --pst-font-family-monospace: BerkeleyMono, ui-monospace, 'Cascadia Code', 'Source Code Pro', Menlo, Consolas, 'DejaVu Sans Mono', monospace;
 }

docs/conf.py

@@ -32,6 +32,7 @@
     "sphinx.ext.viewcode",
     "sphinxcontrib.mermaid",
     "sphinxext.opengraph",
+    "sphinx_copybutton",
 ]
 
 myst_enable_extensions = [
@@ -99,15 +100,8 @@
 
 # -- Options for HTML output --------------------------------------------------
 
-html_theme = "furo"
-html_theme_options = {
-    "top_of_page_buttons": [],
-    "light_css_variables": {
-        "font-stack": "Atkinson Hyperlegible, sans-serif",
-        "font-stack--monospace": "BerkeleyMono, MonoLisa, ui-monospace, "
-        "SFMono-Regular, Menlo, Consolas, Liberation Mono, monospace",
-    },
-}
+html_theme = "sphinx_book_theme"
+html_theme_options = {}
 html_logo = "_static/structlog_logo.svg"
 html_static_path = ["_static"]
 html_css_files = ["custom.css"]

docs/console-output.md

@@ -12,6 +12,8 @@ Rich takes precedence over *better-exceptions*, but you can configure it by pass
 The following output is rendered using Rich:
 
 ```{figure} _static/console_renderer.png
+:alt: Screenshot of colorful console output by ConsoleRenderer.
+
 Colorful console output by ConsoleRenderer.
 ```
 

pyproject.toml

@@ -52,9 +52,11 @@ tests = [
 typing = ["mypy>=1.4", "rich", "twisted"]
 docs = [
     "cogapp",
-    "furo",
     "myst-parser",
     "sphinx",
+    "sphinx-design",
+    "sphinx-copybutton",
+    "sphinx-book-theme",
     "sphinx-notfound-page",
     "sphinxcontrib-mermaid",
     "sphinxext-opengraph",