Python Docs Sphinx Theme

This is the theme for the Python documentation. It requires Python 3.12 or newer and Sphinx 7.3 or newer.

Note that when adopting this theme, you're also borrowing an element of the trust and credibility established by the CPython core developers over the years. That's fine, and you're welcome to do so for other Python community projects if you so choose, but please keep in mind that in doing so you're also choosing to accept some of the responsibility for maintaining that collective trust.

To use the theme, install it into your docs build environment via pip (preferably in a virtual environment).

Configuration options

To use this theme, add the following to conf.py:

html_theme = 'python_docs_theme'
html_sidebars, defaults taken from https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_sidebars

Preview

See a demo of the CPython docs using this theme:

https://python-docs-theme-previews.readthedocs.io

The kitchen sink is a showcase of every Sphinx feature:

https://sphinx-themes.org/sample-sites/python-docs-theme/kitchen-sink/

Uh oh!

License

python/python-docs-theme

About

Resources

License

Code of conduct

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 23

Sponsor this project

Uh oh!

Packages 0

Used by 2k

Contributors 42

Languages

Packages