returnmax(self,key=Version.as_tuple)

defsetup_indexsidebar(self,current:Version,dest_path:Path)->None:

template=jinja2.Template(template_path.read_text(encoding="UTF-8"))

rendered_template=template.render(

current_version=current,

versions=list(reversed(self)),

)

dest_path.write_text(rendered_template,encoding="UTF-8")

classVersion:

version:Version

versions:Versions

language:Language

cpython_repo:Repository

docs_by_version_content:bytes

switchers_content:bytes

build_root:Path

www_root:Path

text=text.replace(" -A switchers=1","")

(self.checkout/"Doc"/"Makefile").write_text(text,encoding="utf-8")

self.versions.setup_indexsidebar(

self.version,

self.checkout/"Doc"/"tools"/"templates"/"indexsidebar.html",

)

self.setup_indexsidebar()

run_with_logging([

"make",

"-C",

run([venv_path/"bin"/"python","-m","pip","freeze","--all"])

self.venv=venv_path

defsetup_indexsidebar(self)->None:

tmpl_dst=self.checkout/"Doc"/"tools"/"templates"

shutil.copy(tmpl_src/"indexsidebar.html",tmpl_dst/"indexsidebar.html")

ifself.version.status!="EOL":

dbv_path.write_bytes(self.docs_by_version_content)

else:

shutil.copy(tmpl_src/"_docs_by_version.html",dbv_path)

defcopy_build_to_webroot(self,http:urllib3.PoolManager)->None:

logging.info("Publishing start.")

force_build=args.force

delargs.force

docs_by_version_content=render_docs_by_version(versions).encode()

switchers_content=render_switchers(versions,languages)

build_succeeded=set()

scope=sentry_sdk.get_isolation_scope()

scope.set_tag("version",version.name)

scope.set_tag("language",language.tag)

cpython_repo.update()

cpython_repo.update()

builder=DocBuilder(

version,

versions,

language,

cpython_repo,

docs_by_version_content,

switchers_content,

**vars(args),

)

returnLanguages.from_json(config["defaults"],config["languages"])

defrender_docs_by_version(versions:Versions)->str:

links= [f'<li><a href="{v.url}">{v.title}</a></li>'forvinreversed(versions)]

return"\n".join(links)

defrender_switchers(versions:Versions,languages:Languages)->bytes:

language_pairs=sorted((l.tag,l.switcher_label)forlinlanguagesifl.in_prod)# NoQA: E741

version_pairs= [(v.name,v.picker_label)forvinreversed(versions)]

{#

This file is only used in indexsidebar.html, where it is included in the docs

by version list. For non-end-of-life branches, build_docs.py overwrites this

list with the full list of versions.

Keep the following two files synchronised:

* cpython/Doc/tools/templates/_docs_by_version.html

* docsbuild-scripts/templates/_docs_by_version.html

#}

<li><ahref="https://docs.python.org/3/">{% trans %}Stable{% endtrans %}</a></li>

<li><ahref="https://docs.python.org/dev/">{% trans %}In development{% endtrans %}</a></li>

{#

Beware, this file is rendered twice via Jinja2:

- First by build_docs.py, given 'current_version' and 'versions'.

- A 2nd time by Sphinx.

#}

{% raw %}

<h3>{% trans %}Download{% endtrans %}</h3>

<p><ahref="{{ pathto('download') }}">{% trans %}Download these documents{% endtrans %}</a></p>

{% endraw %}

{% if current_version.status != "EOL" %}

{% raw %}<h3>{% trans %}Docs by version{% endtrans %}</h3>{% endraw %}

<h3>{% trans %}Docs by version{% endtrans %}</h3>

{% for version in versions %}

<li><ahref="{{ version.url }}">{{ version.title }}</a></li>

{% endfor %}

{% raw %}<li><ahref="https://www.python.org/doc/versions/">{% trans %}All versions{% endtrans %}</a></li>{% endraw %}

{# _docs_by_version.html is overwritten by build_docs.py for non-EOL versions #}

{% include "_docs_by_version.html" without context %}

<li><ahref="https://www.python.org/doc/versions/">{% trans %}All versions{% endtrans %}</a></li>

{% endif %}

{% raw %}

<h3>{% trans %}Other resources{% endtrans %}</h3>

{# XXX: many of these should probably be merged in the main docs #}

<li><ahref="https://peps.python.org">{% trans %}PEP Index{% endtrans %}</a></li>

<li><ahref="https://peps.python.org/">{% trans %}PEP Index{% endtrans %}</a></li>

<li><ahref="https://wiki.python.org/moin/BeginnersGuide">{% trans %}Beginner's Guide{% endtrans %}</a></li>

<li><ahref="https://wiki.python.org/moin/PythonBooks">{% trans %}Book List{% endtrans %}</a></li>

<li><ahref="https://www.python.org/doc/av/">{% trans %}Audio/Visual Talks{% endtrans %}</a></li>

<li><ahref="https://devguide.python.org/">{% trans %}Python Developer’s Guide{% endtrans %}</a></li>

{% endraw %}