Metadata-Version: 2.4
Name: pymc-sphinx-theme
Version: 0.16.0
Summary: A thin sphinx theme to customize pydata-sphinx-theme consistently cross PyMC websites.
Author-email: PyMC Team <pymc.devs@gmail.com>
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
License-File: LICENSE
Requires-Dist: pydata-sphinx-theme>=0.16.0,<0.17,!=0.16.1
Requires-Dist: sphinx>=5
Project-URL: documentation, https://www.pymc.io
Project-URL: source, https://github.com/pymc-devs/pymc-sphinx-theme
Project-URL: tracker, https://github.com/pymc-devs/pymc-sphinx-theme/issues

# pymc-sphinx-theme

A thin sphinx theme to customize [pydata-sphinx-theme](https://pydata-sphinx-theme.readthedocs.io) (PST) consistently cross PyMC websites.

## Theme customizations

### Custom search page
PyMC docs are organized as subprojects in readthedocs. The custom search page shows two
search bars, one that triggers the readthedocs search function of the parent project
and that allows searching accross subprojects, and the PST one for local search
within that particular project only.

![Search page with two search bars](./screenshots/double_search_bar.png)

![Flyout of the global readthedocs search](./screenshots/global_rtd_search.png)

### Centralize navbar customization
The version indicator by the logo/project name is added as well as the mastodon, twitter,
youtube and discord icon links. If no icon links are provided by the specific project,
an extra link to the GitHub org is added, otherwise the project provided links are extended
with the four mentioned.

### Extra right sidebar elements
An extra "Support PyMC" link to the NumFOCUS donation page is automatically added,
and the template of the "Edit on GitHub" link is modified so it is not shown in API pages that
are generated from a docstring. The logic of this exclusion is extremely simple, as we use
`:toctree: generated/` as autosummary option, pages with "generated" in their path are excluded.

