Modernise SKC docs theme

Author: stackhpc-ci

doc/requirements.txt

@@ -3,3 +3,4 @@ sphinx-copybutton # MIT
 sphinx-substitution-extensions # MIT
 sphinx>=4.2.0 # BSD
 sphinxcontrib-svg2pdfconverter>=0.1.0 # BSD
+sphinx-immaterial # MIT

doc/source/conf.py

@@ -52,6 +52,7 @@
 # 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_immaterial',
     'reno.sphinxext',
     #'sphinx.ext.autodoc',
     'sphinx.ext.extlinks',
@@ -89,15 +90,23 @@
 # The theme to use for HTML and HTML Help pages.  Major themes that come with
 # Sphinx are currently 'default' and 'sphinxdoc'.
 # html_theme_path = []
-html_theme = 'default'
+html_theme = 'sphinx_immaterial'
 # html_static_path = ['static']
 
 # Add any paths that contain "extra" files, such as .htaccess or
 # robots.txt.
 # html_extra_path = ['_extra']
 
 html_theme_options = {
-    # "show_other_versions": True,
+    "features": [
+        "navigation.expand",
+        "navigation.top",
+        "navigation.footer",
+        "search.suggest",
+        "content.code.copy",
+        "toc.follow",
+        "toc.sticky",
+    ]
 }
 
 # Output file base name for HTML help builder.