diff --git a/.gitignore b/.gitignore
index d9c4a7972f076d..1cdcf0b8953d78 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,14 @@
+##########################################################################
+# Added by this RTD fork repo:
+# https://github.com/python-docs-101/Python-Documentation-Theme-Fork
+##########################################################################
+.config/*
+__notes__*
+
+##########################################################################
+# Original .gitignore below this comment
+##########################################################################
+
#####
# First, rules intended to apply in all subdirectories.
# These contain no slash, or only a trailing slash.
diff --git a/Doc/_static/css_for_fork/py_rtd_fork.css b/Doc/_static/css_for_fork/py_rtd_fork.css
new file mode 100644
index 00000000000000..edf857348153d8
--- /dev/null
+++ b/Doc/_static/css_for_fork/py_rtd_fork.css
@@ -0,0 +1,92 @@
+/* Import from original theme. */
+pre {
+ padding: 5px;
+ background-color: #eeffcc;
+ color: #333333;
+ line-height: 120%;
+ border: 1px solid #ac9;
+ border-left: none;
+ border-right: none;
+}
+
+/* Import from original theme. */
+div.body a {
+ color: #0072aa;
+}
+div.body a:visited {
+ color: #6363bb;
+}
+div.body a:hover {
+ color: #00B0E4;
+}
+/* minor edit to add scope `div.wy-nav-content` to fix sidebar */
+div.wy-nav-content a code span.pre {
+ color: #2980b9;
+}
+
+/* Import from original theme.
+ Fixes an awful issue where RTD theme settings made non-hyperlinks look like hyperlinks.
+*/
+html.writer-html4 .rst-content dl:not(.docutils)>dt, html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt {
+ color: #222222;
+}
+
+/* Import from original theme.
+ Make inline code blocks look more like GitHub and Slack
+*/
+code,
+.rst-content code,
+.rst-content code.literal,
+.rst-content tt,
+.rst-content tt.literal {
+ color: #333333;
+ padding: 0 1px 0 1px;
+ font-size: 0.95em;
+ background-color: #ecf0f3;
+}
+
+/* Import from original theme. */
+a.headerlink {
+ visibility: hidden;
+}
+
+a.brackets:before {
+ content: "[";
+}
+
+a.brackets:after {
+ content: "]";
+}
+
+
+/* Import from original theme. */
+span.linkdescr {
+ font-style: italic;
+ padding-top: 5px;
+ font-size: 90%;
+}
+a.biglink {
+ font-size: 1.3em;
+}
+
+div.footer {
+ line-height: 150%;
+ margin-top: -2em;
+ text-align: right;
+ width: auto;
+ margin-right: 10px;
+ font-size: 75%;
+ padding: 9px 0 9px 0;
+}
+
+
+a.icon.icon-home::before {
+ content: '';
+ height: 21px;
+ width: 21px;
+ margin-left: -8px;
+ margin-bottom: -4px;
+ background: url(https://python-docs-101.github.io/_static/py.svg);
+ background-size: 19px 20px;
+ background-repeat: no-repeat;
+}
\ No newline at end of file
diff --git a/Doc/_static/py.svg b/Doc/_static/py.svg
new file mode 100644
index 00000000000000..90b6c9004b7418
--- /dev/null
+++ b/Doc/_static/py.svg
@@ -0,0 +1,14 @@
+
diff --git a/Doc/conf.py b/Doc/conf.py
index b3da8fa9ec4497..b92ff7ecf35e8a 100644
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -85,16 +85,146 @@
# Options for HTML output
# -----------------------
-# Use our custom theme.
-html_theme = 'python_docs_theme'
-html_theme_path = ['tools']
+
+##<>=========================================================
+## @@~@@ FORK MODIFIES THIS SECTOION -- replaced
+##===========================================================
+## Original options using `html_theme = 'python_docs_theme'`
+##===========================================================
+# # Use our custom theme.
+# html_theme = 'python_docs_theme'
+# html_theme_path = ['tools']
+# html_theme_options = {
+# 'collapsiblesidebar': True,
+# 'issues_url': '/bugs.html',
+# 'license_url': '/license.html',
+# 'root_include_title': False # We use the version switcher instead.
+# }
+##========================================================
+
+
+##<>=========================================================
+## @@~@@ FORK MODIFIES THIS SECTOION -- added
+##===========================================================
+## Original options using `html_theme = 'python_docs_theme'`
+##===========================================================
+html_theme = 'sphinx_rtd_theme'
+html_theme_path = ['']
+html_favicon = '_static/py.svg'
+# html_logo = '_static/py.svg'
html_theme_options = {
- 'collapsiblesidebar': True,
+ #-------------------------------------------------------------------
+ # Add these variables manually to:
+ # Doc/venv/lib/python3.9/site-packages/sphinx_rtd_theme/theme.conf
+ # then they can be accessed via theme_issues_url + theme_license_url
+ #-------------------------------------------------------------------
'issues_url': '/bugs.html',
'license_url': '/license.html',
- 'root_include_title': False # We use the version switcher instead.
+
+ #***************************************************************
+ # DOCS: sphinx_rtd_theme : collapse_navigation *
+ #***************************************************************
+ # Poorly named. *
+ # *
+ # From sphinx-rtd-theme.readthedocs.io: *
+ # *
+ # Type: boolean *
+ # Default: True *
+ # *
+ # Description: *
+ # *
+ # With collapse_navigation enabled *
+ # *
+ # Navigation entries are not expandable *
+ # – the [+] icons next to each entry are removed. *
+ # *
+ #***************************************************************
+ # This really means, *
+ # "Do you want to collapse all the nav *
+ # and not include sub-pages?" *
+ # *
+ # We want to tell it: *
+ # "False, I wish to include sub-pages." *
+ #***************************************************************
+ 'collapse_navigation': False,
+
+ #**********************************************************************
+ # DOCS: sphinx_rtd_theme : navigation_depth *
+ #**********************************************************************
+ # *
+ # From sphinx-rtd-theme.readthedocs.io: *
+ # *
+ # Type: integer *
+ # Default: 4 *
+ # *
+ # Description: *
+ # The maximum depth of the table of contents tree. *
+ # Set this to -1 to allow unlimited depth. *
+ # *
+ #**********************************************************************
+ 'navigation_depth': -1,
+
+ #************************************************************
+ # DOCS: sphinx_rtd_theme : titles_only *
+ #************************************************************
+ # *
+ # From sphinx-rtd-theme.readthedocs.io: *
+ # *
+ # Type: boolean *
+ # Default: False *
+ # *
+ # Description: *
+ # When enabled, page subheadings *
+ # are not included in the navigation. *
+ # *
+ #************************************************************
+ 'titles_only': False,
+
+ #************************************************************
+ # DOCS: sphinx_rtd_theme : warning *
+ #************************************************************
+ # *
+ # Note: *
+ # *
+ # Setting collapse_navigation to False *
+ # and using a high value for navigation_depth *
+ # on projects with many files and a deep file structure *
+ # *
+ # can cause long compilation times *
+ # and can result in HTML files *
+ # that are significantly larger in file size. *
+ # *
+ #************************************************************
}
+##========================================================
+## @@~@@ FORK MODIFIES THIS SECTOION -- added
+## endof update
+##===========================================================
+
+##-------------------------------------------------------------------------
+## <> RTD CSS Config
+##-------------------------------------------------------------------------
+## See
+## https://docs.readthedocs.io/en/stable/guides/adding-custom-css.html
+##-------------------------------------------------------------------------
+# These folders are copied to the documentation's HTML output
+html_static_path = ['_static']
+
+# These paths are either relative to html_static_path
+# or fully qualified paths (eg. https://...)
+html_css_files = [
+ 'css_for_fork/py_rtd_fork.css',
+]
+##-------------------------------------------------------------------------
+## RTD CSS Config
+##-------------------------------------------------------------------------
+
+
+
+
+
+
# Override stylesheet fingerprinting for Windows CHM htmlhelp to fix GH-91207
# https://github.com/python/cpython/issues/91207
if any('htmlhelp' in arg for arg in sys.argv):
diff --git a/Doc/contents.rst b/Doc/contents.rst
index 464f93bdf85f95..54e2c72197de75 100644
--- a/Doc/contents.rst
+++ b/Doc/contents.rst
@@ -2,29 +2,40 @@
Python Documentation contents
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-.. toctree::
+.. |hr| raw:: html
+
+
+.. toctree::
+
whatsnew/index.rst
+ ----------------------
tutorial/index.rst
- using/index.rst
- reference/index.rst
library/index.rst
+ reference/index.rst
+ using/index.rst
+ howto/index.rst
+
+ ----------------------
+ installing/index.rst
+ distributing/index.rst
extending/index.rst
c-api/index.rst
- distributing/index.rst
- installing/index.rst
- howto/index.rst
faq/index.rst
+
+ ----------------------
+
+ Python Module Index
+ General Index
+ Search page
+ Complete TOC
glossary.rst
-
+
+ ----------------------
about.rst
+ Contributing to Docs
bugs.rst
- copyright.rst
license.rst
+ copyright.rst
.. to include legacy packaging docs in build
-
-.. toctree::
- :hidden:
-
- install/index.rst
diff --git a/Doc/installing/index.rst b/Doc/installing/index.rst
index e158bf1c4c0c7f..f20648cdc89777 100644
--- a/Doc/installing/index.rst
+++ b/Doc/installing/index.rst
@@ -239,3 +239,9 @@ obtaining other binary extensions without needing to build them locally.
`Python Packaging User Guide: Binary Extensions
`__
+
+
+.. toctree::
+ :hidden:
+
+ ../install/index.rst
diff --git a/Doc/requirements.txt b/Doc/requirements.txt
index 71d3cd61e53877..10cb18218a61b3 100644
--- a/Doc/requirements.txt
+++ b/Doc/requirements.txt
@@ -1,3 +1,17 @@
+##########################################################################
+# Added by this RTD fork repo:
+# https://github.com/python-docs-101/Python-Documentation-Theme-Fork
+##########################################################################
+
+sphinx_rtd_theme
+
+
+
+##########################################################################
+# Original requirements.txt below this comment
+##########################################################################
+
+
# Requirements to build the Python documentation
# Sphinx version is pinned so that new versions that introduce new warnings
diff --git a/Doc/tools/templates/footerdonate.html b/Doc/tools/templates/footerdonate.html
new file mode 100644
index 00000000000000..2aef2ac214d738
--- /dev/null
+++ b/Doc/tools/templates/footerdonate.html
@@ -0,0 +1,3 @@
+{% trans %}The Python Software Foundation is a non-profit corporation.{% endtrans %}
+{% trans %}Please donate.{% endtrans %}
+
diff --git a/Doc/tools/templates/indexcontent.html b/Doc/tools/templates/indexcontent.html
index a96746b69fd41b..db45b8004d9990 100644
--- a/Doc/tools/templates/indexcontent.html
+++ b/Doc/tools/templates/indexcontent.html
@@ -5,8 +5,24 @@
{% block body %}
{{ docstitle|e }}
- {% trans %}Welcome! This is the official documentation for Python {{ release }}.{% endtrans %}
+ {% trans %}Welcome! This is
+
+
+ A FORK OF
+
+
+ the official documentation for Python {{ release }}.{% endtrans %}
+
+ Fork note:
+
+ ◀ We added a TOC sidebar to this entire site!
+
+ Otherwise, the rest of this repo is identical to the main docs at https://docs.python.org
+
+ Happy coding 👩💻
+
+
{% trans %}Parts of the documentation:{% endtrans %}
diff --git a/Doc/venv/lib/python3.9/site-packages/sphinx_rtd_theme/breadcrumbs.html b/Doc/venv/lib/python3.9/site-packages/sphinx_rtd_theme/breadcrumbs.html
new file mode 100644
index 00000000000000..a583588bc73900
--- /dev/null
+++ b/Doc/venv/lib/python3.9/site-packages/sphinx_rtd_theme/breadcrumbs.html
@@ -0,0 +1,77 @@
+{%- if meta is defined and meta is not none %}
+ {%- set check_meta = True %}
+{%- else %}
+ {%- set check_meta = False %}
+{%- endif %}
+
+{%- if check_meta and 'github_url' in meta %}
+ {%- set display_github = True %}
+{%- endif %}
+
+{%- if check_meta and 'bitbucket_url' in meta %}
+ {%- set display_bitbucket = True %}
+{%- endif %}
+
+{%- if check_meta and 'gitlab_url' in meta %}
+ {%- set display_gitlab = True %}
+{%- endif %}
+
+{%- set display_vcs_links = display_vcs_links if display_vcs_links is defined else True %}
+
+{#- Translators: This is an ARIA section label for page links, including previous/next page link and links to GitHub/GitLab/etc. -#}
+
+
+ {%- if (theme_prev_next_buttons_location == 'top' or theme_prev_next_buttons_location == 'both') and (next or prev) %}
+ {#- Translators: This is an ARIA section label for sequential page links, such as previous and next page links. -#}
+
diff --git a/Doc/venv/lib/python3.9/site-packages/sphinx_rtd_theme/footer.html b/Doc/venv/lib/python3.9/site-packages/sphinx_rtd_theme/footer.html
new file mode 100644
index 00000000000000..d24e120d332e37
--- /dev/null
+++ b/Doc/venv/lib/python3.9/site-packages/sphinx_rtd_theme/footer.html
@@ -0,0 +1,53 @@
+
diff --git a/Doc/venv/lib/python3.9/site-packages/sphinx_rtd_theme/layout.html b/Doc/venv/lib/python3.9/site-packages/sphinx_rtd_theme/layout.html
new file mode 100644
index 00000000000000..ca07fe267a5b8d
--- /dev/null
+++ b/Doc/venv/lib/python3.9/site-packages/sphinx_rtd_theme/layout.html
@@ -0,0 +1,250 @@
+{# TEMPLATE VAR SETTINGS #}
+{%- set url_root = pathto('', 1) %}
+{%- if url_root == '#' %}{% set url_root = '' %}{% endif %}
+{%- if not embedded and docstitle %}
+ {%- set titlesuffix = " — "|safe + docstitle|e %}
+{%- else %}
+ {%- set titlesuffix = "" %}
+{%- endif %}
+{%- set lang_attr = 'en' if language == None else (language | replace('_', '-')) %}
+{%- set sphinx_writer = 'writer-html5' if html5_doctype else 'writer-html4' -%}
+
+{# Build sphinx_version_info tuple from sphinx_version string in pure Jinja #}
+{%- set (_ver_major, _ver_minor) = (sphinx_version.split('.') | list)[:2] | map('int') -%}
+{%- set sphinx_version_info = (_ver_major, _ver_minor, -1) -%}
+
+
+
+
+
+ {{- metatags }}
+
+ {%- block htmltitle %}
+ {{ title|striptags|e }}{{ titlesuffix }}
+ {%- endblock -%}
+
+ {#- CSS #}
+ {%- if sphinx_version_info < (4, 0) -%}
+
+
+ {%- endif %}
+ {%- for css in css_files %}
+ {%- if css|attr("rel") %}
+
+ {%- else %}
+
+ {%- endif %}
+ {%- endfor %}
+
+ {%- for cssfile in extra_css_files %}
+
+ {%- endfor -%}
+
+ {#- FAVICON
+ favicon_url is the only context var necessary since Sphinx 4.
+ In Sphinx<4, we use favicon but need to prepend path info.
+ #}
+ {%- set _favicon_url = favicon_url | default(pathto('_static/' + (favicon or ""), 1)) %}
+ {%- if favicon_url or favicon %}
+
+ {%- endif %}
+
+ {#- CANONICAL URL (deprecated) #}
+ {%- if theme_canonical_url and not pageurl %}
+
+ {%- endif -%}
+
+ {#- CANONICAL URL #}
+ {%- if pageurl %}
+
+ {%- endif -%}
+
+ {#- JAVASCRIPTS #}
+ {%- block scripts %}
+
+ {%- if not embedded %}
+ {# XXX Sphinx 1.8.0 made this an external js-file, quick fix until we refactor the template to inherert more blocks directly from sphinx #}
+ {%- if sphinx_version_info >= (1, 8) -%}
+ {%- if sphinx_version_info < (4, 0) -%}
+
+ {%- endif -%}
+ {%- for scriptfile in script_files %}
+ {{ js_tag(scriptfile) }}
+ {%- endfor %}
+ {%- else %}
+
+ {%- for scriptfile in script_files %}
+
+ {%- endfor %}
+ {%- endif %}
+
+
+ {#- OPENSEARCH #}
+ {%- if use_opensearch %}
+
+ {%- endif %}
+ {%- endif %}
+ {%- endblock %}
+
+ {%- block linktags %}
+ {%- if hasdoc('about') %}
+
+ {%- endif %}
+ {%- if hasdoc('genindex') %}
+
+ {%- endif %}
+ {%- if hasdoc('search') %}
+
+ {%- endif %}
+ {%- if hasdoc('copyright') %}
+
+ {%- endif %}
+ {%- if next %}
+
+ {%- endif %}
+ {%- if prev %}
+
+ {%- endif %}
+ {%- endblock %}
+ {%- block extrahead %} {% endblock %}
+
+
+
+
+ {%- block extrabody %} {% endblock %}
+
+ {#- SIDE NAV, TOGGLES ON MOBILE #}
+
+
+
+
+ {#- MOBILE NAV, TRIGGLES SIDE NAV ON TOGGLE #}
+ {#- Translators: This is an ARIA section label for the navigation menu that is visible when viewing the page on mobile devices -#}
+
+
+