Update theme (pymc-devs#792)

* update theme

* configure search and use pypi release

Author: OriolAbril

.readthedocs.yml

@@ -11,3 +11,24 @@ build:
 python:
    install:
    - requirements: requirements-docs.txt
+
+search:
+  ranking:
+    _sources/*: -10
+    genindex.html: -9
+    blog/tag/*: -2
+    blog/category/*: -3
+    blog/author/*: -5
+    blog/20[0-9].html: -5
+    blog/archive.html: -5
+    blog/author.html: -5
+    blog/category.html: -5
+    blog/drafts.html: -5
+    blog/tag.html: -5
+    blog.html: -5
+    object_index/*: -1
+
+  ignore:
+    - 404.html
+    - search.html
+    - index.html

examples/conf.py

@@ -83,6 +83,14 @@ def setup(app: Sphinx):
     "article_header_end": ["nb-badges"],
     "show_prev_next": True,
     "article_footer_items": ["rendered_citation.html"],
+    "search_bar_text": "Search within the PyMC example gallery...",
+    "icon_links": [
+        {
+            "url": "https://github.com/pymc-devs/pymc-examples",
+            "icon": "fa-brands fa-github",
+            "name": "GitHub",
+        },
+    ],
 }
 version = version if "." in rtd_version else "main"
 doi_code = os.environ.get("DOI_READTHEDOCS", "10.5281/zenodo.5654871")

requirements-docs.txt

@@ -3,7 +3,7 @@ matplotlib
 myst-nb
 sphinx-codeautolink
 sphinx>=5
-pymc-sphinx-theme
+pymc-sphinx-theme>=0.16
 sphinx-copybutton
 sphinx-design
 sphinx-notfound-page