1
- Python Docs Sphinx Theme
2
- =========================
1
+ #Python Docs Sphinx Theme
3
2
4
3
This is the theme for the Python documentation.
5
4
@@ -10,22 +9,24 @@ projects if you so choose, but please keep in mind that in doing so you're also
10
9
choosing to accept some of the responsibility for maintaining that collective
11
10
trust.
12
11
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 `
14
13
(preferably in a virtual environment).
15
14
16
15
17
- Configuration options
18
- ---------------------
16
+ ##Configuration options
19
17
20
- To use this theme, add the following to `` conf.py ` `:
18
+ To use this theme, add the following to` conf.py ` :
21
19
22
- - `` html_theme = 'python_docs_theme' ` `
20
+ - ` html_theme = 'python_docs_theme' `
23
21
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
25
23
26
- Preview
27
- -------
24
+ ##Preview
28
25
29
26
See a demo of the CPython docs using this theme:
30
27
31
28
- 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/