This is the theme for the Python documentation.

It requires Python 3.10 or newer and Sphinx 7.2 or newer.

It requires Python 3.10 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

"Topic :: Software Development :: Documentation",

]

dependencies = [

"sphinx>=7.2",

"sphinx>=7.3",

]

urls.Code ="https://github.com/python/python-docs-theme"

from __future__importannotations

THEME_PATH=Path(__file__).parent.resolve()

ifTYPE_CHECKING:

fromsphinx.applicationimportSphinx

fromsphinx.util.typingimportExtensionMetadata

THEME_PATH=Path(__file__).resolve().parent

defsetup(app):

app.require_sphinx("7.2")

current_dir=os.path.abspath(os.path.dirname(__file__))

app.add_html_theme("python_docs_theme",current_dir)

defsetup(app:Sphinx)->ExtensionMetadata:

app.require_sphinx("7.3")

app.add_html_theme("python_docs_theme",THEME_PATH)

return {

"version":"2024.12",

[theme]

inherit ="default"

stylesheets = [

"pydoctheme.css",

]

pygments_style = {default ="default",dark ="monokai" }

[options]

bodyfont ="-apple-system, BlinkMacSystemFont, avenir next, avenir, segoe ui, helvetica neue, helvetica, Cantarell, Ubuntu, roboto, noto, arial, sans-serif"

headfont ="-apple-system, BlinkMacSystemFont, avenir next, avenir, segoe ui, helvetica neue, helvetica, Cantarell, Ubuntu, roboto, noto, arial, sans-serif"

footerbgcolor ="white"

footertextcolor ="#555555"

relbarbgcolor ="white"

relbartextcolor ="#666666"

relbarlinkcolor ="#444444"

sidebarbgcolor ="white"

sidebartextcolor ="#444444"

sidebarlinkcolor ="#444444"

sidebarbtncolor ="#cccccc"

bgcolor ="white"

textcolor ="#222222"

linkcolor ="#0090c0"

visitedlinkcolor ="#00608f"

headtextcolor ="#1a1a1a"

headbgcolor ="white"

headlinkcolor ="#aaaaaa"

codebgcolor ="#eeffcc"

codetextcolor ="#333333"

hosted_on =""

issues_url =""

license_url =""

root_name ="Python"

root_url ="https://www.python.org/"

root_icon ="py.svg"

root_icon_alt_text ="Python logo"

root_include_title ="True"

copyright_url =""