1- Python Docs Sphinx Theme
2- =========================
1+ #Python Docs Sphinx Theme
32
43This is the theme for the Python documentation.
54
@@ -10,22 +9,24 @@ projects if you so choose, but please keep in mind that in doing so you're also
109choosing to accept some of the responsibility for maintaining that collective
1110trust.
1211
13- To use the theme, install it into your docs build environment via `` pip ` `
12+ To use the theme, install it into your docs build environment via` pip `
1413(preferably in a virtual environment).
1514
1615
17- Configuration options
18- ---------------------
16+ ##Configuration options
1917
20- To use this theme, add the following to `` conf.py ` `:
18+ To use this theme, add the following to` conf.py ` :
2119
22- - `` html_theme = 'python_docs_theme' ` `
20+ - ` html_theme = 'python_docs_theme' `
2321
24- - `` html_sidebars ` `, defaults taken from https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_sidebars
22+ - ` html_sidebars ` , defaults taken fromhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_sidebars
2523
26- Preview
27- -------
24+ ##Preview
2825
2926See a demo of the CPython docs using this theme:
3027
3128- https://python-docs-theme-previews.readthedocs.io
29+
30+ The kitchen sink is a showcase of every Sphinx feature:
31+
32+ - https://sphinx-themes.org/sample-sites/python-docs-theme/kitchen-sink/