python-docs-theme
The Sphinx theme for the CPython docs and related projects
Decision gist · record as of 2026-08-14
Yes, if you're building Sphinx docs for a Python project and want the official Python docs appearance. The theme is actively maintained, has no known vulnerabilities, and carries a permissive license. The only real consideration is the implicit social contract: adopting this theme signals alignment with Python community standards, which is appropriate for most Python projects but worth acknowledging intentionally.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.12 or newer and Sphinx 7.3 or newer.
- Low friction install with a single runtime dependency on Sphinx.
- Active maintenance, last release 18 days ago, and repository shows recent activity.
License · maintenance · safety
PSF-2.0 (permissive) — Licensed under PSF-2.0 (permissive), allowing use in both open and closed projects with minimal restrictions.
last release 2026-07-27 (18 days) · last repo commit 2026-08-01 · 89 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 207,140 downloads/mo, #9,557 on PyPI
Alternatives
Verify before relying
pip install python-docs-theme
# In conf.py:
html_theme = 'python_docs_theme'- Whether the theme's sidebar and layout options are fully documented beyond the basic conf.py configuration mentioned.
- How well the theme handles custom Sphinx extensions or non-standard markup.
- Whether adopting this theme's visual identity carries any implicit expectations from the Python community beyond the stated trust/credibility note.
What it is and what it does
python-docs-theme is a Sphinx theme that replicates the appearance and structure of the official CPython documentation. It's designed for Python community projects that want to adopt the familiar look of python.org docs. The theme depends only on Sphinx and is straightforward to integrate—you install it via pip and set html_theme = 'python_docs_theme' in your Sphinx conf.py.
The package carries a notable social dimension: using it borrows credibility from the CPython core developers' long-established documentation standards. The maintainers explicitly note that adopting the theme means accepting some responsibility for maintaining the trust associated with that visual identity. The theme supports localization and offers configuration options for sidebars; a live preview is available on ReadTheDocs.
Use it for
- Style your Python library or framework docs to match the official Python documentation look and feel.
- Create community-maintained Python documentation that inherits visual consistency with python.org.
- Build Sphinx-based docs for Python Enhancement Proposals (PEPs) or other CPython-adjacent projects.
- Localize Python documentation using the theme's built-in translation support.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you're building Sphinx docs for a Python project and want the official Python docs appearance.
The theme is actively maintained, has no known vulnerabilities, and carries a permissive license. The only real consideration is the implicit social contract: adopting this theme signals alignment with Python community standards, which is appropriate for most Python projects but worth acknowledging intentionally.
Install
python-docs-theme on PyPI
Before you install
Low friction install with a single runtime dependency on Sphinx. Active maintenance, last release 18 days ago, and repository shows recent activity.
Requires Python 3.12 or newer and Sphinx 7.3 or newer.
License in practice
Licensed under PSF-2.0 (permissive), allowing use in both open and closed projects with minimal restrictions.
Quickstart
pip install python-docs-theme
# In conf.py:
html_theme = 'python_docs_theme'Verify before relying
- Whether the theme's sidebar and layout options are fully documented beyond the basic conf.py configuration mentioned.
- How well the theme handles custom Sphinx extensions or non-standard markup.
- Whether adopting this theme's visual identity carries any implicit expectations from the Python community beyond the stated trust/credibility note.
Package facts
| License | PSF-2.0 permissive |
| Python support | Supports the current Python release >=3.12 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagesphinx |
| Maintenance | Actively maintained 18 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 207,140 / month, #9,557 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableFramework :: Sphinx :: ThemeIntended Audience :: DevelopersOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.15Topic :: DocumentationTopic :: Software Development :: Documentation |
Evidence: python_docs_theme-2026.7-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “sphinx theme python docs”
- python-docs-themeA Sphinx theme that applies the visual style and layout of the…
- sphinx-rtd-themeA Sphinx theme that renders documentation with a responsive,…
- sphinx-bootstrap-themeA Sphinx theme that applies Bootstrap CSS and JavaScript to…
Give your agent the search over MCP, or paste the wish link into any chat.
More Documentation packages
Docutils converts plaintext documentation in reStructuredText format into multiple output formats including HTML, XML, and LaTeX using a modular processing system.
Sphinx generates professional documentation from reStructuredText source files, producing HTML, PDF, EPUB, and other formats with automatic cross-references, code highlighting, and hierarchical navigation.
Griffe extracts the complete structure and signatures of Python programs to generate API documentation or detect breaking changes in your project's public API.
Install it if you need to programmatically inspect Python code structure, generate API docs, or enforce API stability in CI.
A Sphinx extension that outputs documentation in serialized HTML formats (JSON and pickle) alongside standard HTML.
Alabaster is a clean, responsive Sphinx theme for documentation that requires Python 3.10 or newer and Sphinx 6.2 or newer.
A Sphinx extension that generates HTML help files from reStructuredText documentation source.
See also Pallets-Sphinx-Themes · pydata-sphinx-theme · sphinx-rtd-theme · sphinx-press-theme · sphinx-bootstrap-theme · shibuya · sphinx-book-theme · sphinx-basic-ng · nvidia-sphinx-theme