try immortal theme

docs/conf.py

@@ -55,7 +55,7 @@
     'sphinxcontrib.collections',
     'sphinxcontrib.jquery', # https://github.com/sphinx-contrib/jquery
     'sphinx_preview',
-    #'sphinx_immaterial',
+    'sphinx_immaterial',
 ]
 
 templates_path = ['_templates']
@@ -84,7 +84,7 @@
     # A list of selectors, where no preview icon shall be added, because it makes often no sense.
     # For instance the own ID of a need object, or the link on an image to open the image.
     #"not_selector": "div.needs_head a, h1 a, h2 a, a.headerlink, a.md-content__button, a.image-reference, em.sig-param a, a.paginate_button",
-    "not_selector": "div.needs_head a, h1 a, h2 a, a.headerlink, a.md-content__button, a.image-reference, em.sig-param a, a.paginate_button, a.sd-btn",
+    #"not_selector": "div.needs_head a, h1 a, h2 a, a.headerlink, a.md-content__button, a.image-reference, em.sig-param a, a.paginate_button, a.sd-btn",
     #"not_selector": "div.needs_head a, h1 a, h2 a",
     "set_icon": True,
     "icon_only": True,
@@ -102,9 +102,51 @@
 
 # -- Options for HTML output
 
-html_theme = 'sphinx_rtd_theme'
-#html_theme = 'alabaster'
-#html_theme = 'sphinx_immaterial'
+#html_theme = 'sphinx_rtd_theme'
+html_theme = 'alabaster' # Sphinx Defaul Theme
+
+# Set ``html_theme`` to ``sphinx_immaterial`` only, if we do NOT perform a PDF build.
+if os.environ.get("PDF", 0) != 1:
+   extensions.append("sphinx_immaterial")
+   html_theme = 'sphinx_immaterial'
+
+html_theme_options = {
+    "font": False,
+    "icon": {
+        "repo": "fontawesome/brands/github",
+        "edit": "material/file-edit-outline",
+    },
+    "site_url": "https://jbms.github.io/sphinx-immaterial/",
+    "repo_url": "https://github.dev/PhilipPartsch/ReConf2023-Product-As-Code",
+    "repo_name": "ReConf2023-Product-As-Code",
+    "edit_uri": "blob/main/docs",
+    "globaltoc_collapse": True,
+    "features": [
+        "navigation.expand",
+        # "navigation.tabs",
+        # "toc.integrate",
+        "navigation.sections",
+        # "navigation.instant",
+        # "header.autohide",
+        "navigation.top",
+        # "navigation.tracking",
+        "search.highlight",
+        "search.share",
+        "toc.follow",
+        "toc.sticky",
+        "content.tabs.link",
+        "announce.dismiss",
+    ],
+    "palette": [
+        {
+            "media": "(prefers-color-scheme: light)",
+            "scheme": "default",
+            "primary": "blue",
+            "accent": "light-cyan",
+        },
+    ],
+    "toc_title_is_page_title": True,
+}
 
 html_css_files = ['custom.css']