https://github.com/pymc-devs/pymc-sphinx-theme

A thin sphinx theme to customize pydata-sphinx-theme consistently cross PyMC websites.
https://github.com/pymc-devs/pymc-sphinx-theme

Last synced: 5 months ago
JSON representation

A thin sphinx theme to customize pydata-sphinx-theme consistently cross PyMC websites.

• Host: GitHub
• URL: https://github.com/pymc-devs/pymc-sphinx-theme
• Owner: pymc-devs
• License: other
• Created: 2022-11-13T19:57:33.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-05-12T13:53:11.000Z (about 1 year ago)
• Last Synced: 2025-10-25T10:14:15.867Z (8 months ago)
• Language: HTML
• Homepage:
• Size: 104 KB
• Stars: 1
• Watchers: 8
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 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.