Debian Codegraph @

Doc/tools/templates/download.html

raw
1 {% extends "layout.html" %}
2 {% set title = _('Download') %}
3 {% if daily is defined %}
4 {% set dl_base = pathto('archives', resource=True) %}
5 {% set dl_version = version %}
6 {% else %}
7 {#
8 The link below returns HTTP 404 until the first related alpha release.
9 This is expected; use daily documentation builds for CPython development.
10 #}
11 {% set dl_base = 'https://www.python.org/ftp/python/doc/' + release %}
12 {% set dl_version = release %}
13 {% endif %}
14
15 {%- block extrahead -%}
16 {{ super() }}
17 <meta property="og:title" content="Download — Python {{ dl_version }} documentation">
18 <meta property="og:type" content="website">
19 <meta property="og:url" content="https://docs.python.org/3/download.html">
20 <meta property="og:site_name" content="Python documentation">
21 <meta property="og:description" content="Download Python documentation.">
22 <meta property="og:image" content="https://docs.python.org/3/_static/og-image.png">
23 <meta name="description" content="Download Python documentation.">
24 <meta property="og:image:width" content="200">
25 <meta property="og:image:height" content="200">
26 <meta name="theme-color" content="#3776ab">
27 {%- endblock -%}
28
29 {% block body %}
30 <h1>{% trans %}Download Python {{ dl_version }} documentation{% endtrans %}</h1>
31
32 {% if last_updated %}<p><b>{% trans %}Last updated on: {{ last_updated }}.{% endtrans %}</b></p>{% endif %}
33
34 <p>{% trans %}Download an archive containing all the documentation for this version of Python:{% endtrans %}</p>
35
36 <table class="docutils">
37 <tr>
38 <th>{% trans %}Format{% endtrans %}</th>
39 <th>{% trans %}Packed as .zip{% endtrans %}</th>
40 <th>{% trans %}Packed as .tar.bz2{% endtrans %}</th>
41 </tr>
42 <tr>
43 <td>{% trans %}HTML{% endtrans %}</td>
44 <td>{% trans %}<a href="{{ dl_base }}/python-{{ dl_version }}-docs-html.zip">Download</a>{% endtrans %}</td>
45 <td>{% trans %}<a href="{{ dl_base }}/python-{{ dl_version }}-docs-html.tar.bz2">Download</a>{% endtrans %}</td>
46 </tr>
47 <tr>
48 <td>{% trans %}Plain text{% endtrans %}</td>
49 <td>{% trans %}<a href="{{ dl_base }}/python-{{ dl_version }}-docs-text.zip">Download</a>{% endtrans %}</td>
50 <td>{% trans %}<a href="{{ dl_base }}/python-{{ dl_version }}-docs-text.tar.bz2">Download</a>{% endtrans %}</td>
51 </tr>
52 <tr>
53 <td>{% trans %}Texinfo{% endtrans %}</td>
54 <td>{% trans %}<a href="{{ dl_base }}/python-{{ dl_version }}-docs-texinfo.zip">Download</a>{% endtrans %}</td>
55 <td>{% trans %}<a href="{{ dl_base }}/python-{{ dl_version }}-docs-texinfo.tar.bz2">Download</a>{% endtrans %}</td>
56 </tr>
57 <tr>
58 <td>{% trans %}EPUB{% endtrans %}</td>
59 <td>{% trans %}<a href="{{ dl_base }}/python-{{ dl_version }}-docs.epub">Download</a>{% endtrans %}</td>
60 <td></td>
61 </tr>
62 </table>
63
64 <p>{% trans %}
65 We no longer provide pre-built PDFs of the documentation.
66 To build a PDF archive, follow the instructions in the
67 <a href="https://devguide.python.org/documentation/start-documenting/#building-the-documentation">Developer's Guide</a>
68 and run <code>make dist-pdf</code> in the <code>Doc/</code> directory of a copy of the CPython repository.
69 {% endtrans %}</p>
70
71 <p>{% trans %}
72 See the <a href="https://docs.python.org/{{ version }}/archives/">directory listing</a>
73 for file sizes.{% endtrans %}</p>
74
75 <h2>{% trans %}Problems{% endtrans %}</h2>
76 {% set bugs = pathto('bugs') %}
77 <p>{% trans bugs = bugs %}<a href="{{ bugs }}">Open an issue</a>
78 if you have comments or suggestions for the Python documentation.{% endtrans %}</p>
79 {% endblock %}