From d3a70da9880f16e86bb737d51686fef141f24a90 Mon Sep 17 00:00:00 2001 From: Georg Brandl Date: Mon, 6 Aug 2007 07:57:06 +0000 Subject: [PATCH] Add missing file... --- sphinx/templates/download.html | 56 ++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 sphinx/templates/download.html diff --git a/sphinx/templates/download.html b/sphinx/templates/download.html new file mode 100644 index 000000000..0b794f6e5 --- /dev/null +++ b/sphinx/templates/download.html @@ -0,0 +1,56 @@ +{% extends "layout.html" %} +{% set title = 'Download' %} +{% block body %} + +

Download Python {{ release }} Documentation + {%- if last_updated %} (last updated on {{ last_updated }}){% endif %}

+ +

To download an archive containing all the documents for this version of +Python in one of various formats, follow one of links in this table. The numbers +in the table are the size of the download files in Kilobytes.

+ +{# XXX download links, relative to download_base_url #} + + +

These archives contain all the content in the documentation section.

+ +

Unpacking

+ +

Unix users should download the .tar.bz2 archives; these are bzipped tar +archives and can be handled in the usual way using tar and the bzip2 +program. The InfoZIP unzip program can be +used to handle the ZIP archives if desired. The .tar.bz2 archives provide the +best compression and fastest download times.

+ +

Windows users can use the ZIP archives since those are customary on that +platform. These are created on Unix using the InfoZIP zip program. They may be +unpacked using the free WiZ tool (from the InfoZIP developers) or the +proprietary WinZip 7.0 tool. Many other +tools for handling ZIP archives are available; any of them should work. WinZip +can also handle the gzipped tar archives if needed, but be careful that the +filenames may be mangled if you download these using a Web browser.

+ +

Note that the .tar.bz2 files are smaller than the other archives; Windows +users may want to install the bzip2 tools on their systems as well. Windows +binaries for a command-line tool are available at The bzip2 and libbzip2 official home page, but +most other archiving utilities support the tar and bzip2 formats as well.

+ + +

Problems

+ +

Printing PDFs using Adobe Acrobat Reader 5.0: Adobe has +reportedly admitted that there is a bug in Acrobat Reader 5.0 which causes it +not to print at least some PDF files generated by pdfTeX. This software is used +to produce the PDF version of the Python documentation, and our documents +definately trigger this bug in Acrobat Reader. To print the PDF files, use +Acrobat Reader 4.x, ghostscript, or xpdf.

+ +

Reportedly, Acrobat Reader 6.0 can print these documents without this +problem, but we've not yet had an opportunity to confirm the report. Sadly, +version 6.0 is not yet available on Unix platforms.

+ +

If you have comments or suggestions for the Python documentation, please send +email to docs@python.org.

+ +{% endblock %} \ No newline at end of file