Update docs theme (#7781)

* try updated theme

* updates to conf.py

* configure search and use conda-forge release

Author: OriolAbril

.readthedocs.yml

@@ -15,3 +15,16 @@ build:
   os: "ubuntu-22.04"
   tools:
     python: "mambaforge-4.10"
+
+search:
+  ranking:
+    _sources/*: -10
+    _modules/*: -5
+    genindex.html: -9
+    '*__init__.html': -3
+    '*dist.html': -3
+
+  ignore:
+    - 404.html
+    - search.html
+    - index.html

conda-envs/environment-docs.yml

@@ -26,7 +26,7 @@ dependencies:
 - numpydoc
 - polyagamma
 - pre-commit>=2.8.0
-- pymc-sphinx-theme==0.14
+- pymc-sphinx-theme>=0.16
 - sphinx-copybutton
 - sphinx-design
 - sphinx-notfound-page

docs/source/conf.py

@@ -351,6 +351,14 @@ def setup(app):
     "logo": {
         "link": "https://www.pymc.io",
     },
+    "search_bar_text": "Search within PyMC library docs...",
+    "icon_links": [
+        {
+            "url": "https://github.com/pymc-devs/pymc",
+            "icon": "fa-brands fa-github",
+            "name": "GitHub",
+        },
+    ],
 }
 html_context = {
     "github_user": "pymc-devs",