Description: Use Sphinx RTD theme rather than unpackaged sphinx-immaterial
Forwarded: not-needed
Author: Julian Gilbey <jdg@debian.org>
Last-Update: 2024-11-19

--- a/docs/conf.py
+++ b/docs/conf.py
@@ -15,6 +15,7 @@
 # sys.path.insert(0, os.path.abspath('.'))
 
 import openapi_core
+import sphinx_rtd_theme
 
 # -- Project information -----------------------------------------------------
 
@@ -38,7 +39,7 @@
     "sphinx.ext.intersphinx",
     "sphinx.ext.coverage",
     "sphinx.ext.viewcode",
-    "sphinx_immaterial",
+    "sphinx_rtd_theme",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -55,7 +56,7 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = "sphinx_immaterial"
+html_theme = "sphinx_rtd_theme"
 
 # 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,
@@ -65,41 +67,4 @@
 # Set link name generated in the top bar.
 html_title = "openapi-core"
 
-# Material theme options (see theme.conf for more information)
-html_theme_options = {
-    "analytics": {
-        "provider": "google",
-        "property": "G-J6T05Z51NY",
-    },
-    "repo_url": "https://github.com/python-openapi/openapi-core/",
-    "repo_name": "openapi-core",
-    "icon": {
-        "repo": "fontawesome/brands/github-alt",
-        "edit": "material/file-edit-outline",
-    },
-    "palette": [
-        {
-            "media": "(prefers-color-scheme: dark)",
-            "scheme": "slate",
-            "primary": "lime",
-            "accent": "amber",
-            "scheme": "slate",
-            "toggle": {
-                "icon": "material/toggle-switch",
-                "name": "Switch to light mode",
-            },
-        },
-        {
-            "media": "(prefers-color-scheme: light)",
-            "scheme": "default",
-            "primary": "lime",
-            "accent": "amber",
-            "toggle": {
-                "icon": "material/toggle-switch-off-outline",
-                "name": "Switch to dark mode",
-            },
-        },
-    ],
-    # If False, expand all TOC entries
-    "globaltoc_collapse": False,
-}
+html_baseurl = "https://github.com/python-openapi/openapi-core/"
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -28,19 +28,19 @@
 Installation
 ------------
 
-.. md-tab-set::
+Pip + PyPI (recommended)
+^^^^^^^^^^^^^^^^^^^^^^^^
 
-    .. md-tab-item:: Pip + PyPI (recommented)
+   .. code-block:: console
 
-      .. code-block:: console
+      pip install openapi-core
 
-         pip install openapi-core
+Pip + the source
+^^^^^^^^^^^^^^^^
 
-    .. md-tab-item:: Pip + the source
+   .. code-block:: console
 
-      .. code-block:: console
-
-         pip install -e git+https://github.com/python-openapi/openapi-core.git#egg=openapi_core
+      pip install -e git+https://github.com/python-openapi/openapi-spec-validator.git#egg=openapi_core
 
 First steps
 -----------