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 -
To lay pages out right-to-left for languages such as Persian, Arabic, or Hebrew, set
html_theme_options = {"is_rtl": True}. Defaults tofalse.
Translation
This theme supports localization. For more information see the Python Developer's Guide.
Preview
See a demo of the CPython docs using this theme:
The kitchen sink is a showcase of every Sphinx feature:
5 maintainers
Release files for python-docs-theme 2026.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| python_docs_theme-2026.9.tar.gz | 40.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| python_docs_theme-2026.9-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 89.8 kB
Release files / python_docs_theme-2026.9.tar.gz
| Download URL | python_docs_theme-2026.9.tar.gz |
|---|---|
| Size | 40.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1a400cb5e6ac6c8b4788eb0a98067a8c35e8aea15e38941e90a7f764582702fc
|
|
BLAKE2b-256 checksum How to use checksums |
5a5efee7dbfd6a5ebf27f4a91c8cdf204f35f0744fd1fbde7f50cd479d1d890c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.
Transparency logRelease files / python_docs_theme-2026.9-py3-none-any.whl
| Download URL | python_docs_theme-2026.9-py3-none-any.whl |
|---|---|
| Size | 49.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1a4bdc4f9c664c35a58714af0a98efee4ecb7c3bc4ee0752782c953164ac8fc3
|
|
BLAKE2b-256 checksum How to use checksums |
68e10d603158c9d9a59cd05dfa98a1682c2fffbc387f1e3a724794480f8acaab
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.
Transparency log
