This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Easy tutorial printing should be possible
Type: enhancement Stage:
Components: Documentation Versions:
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: georg.brandl Nosy List: georg.brandl, jackjansen, rhettinger, wspace
Priority: normal Keywords:

Created on 2003-04-03 09:01 by wspace, last changed 2022-04-10 16:08 by admin. This issue is now closed.

Messages (8)
msg53837 - (view) Author: Joost Jacob (wspace) Date: 2003-04-03 09:01
I wanted to print the Python Tutorial by Guido for a 
colleague who might be interested in Python.  But this 
was not easy since it is distributed over a 18 different 
html files!  So now he has something looking bad 
because page numbers restart at every section.  I didn't 
have the time to think of a better solution: I wanted to 
give a printed tutorial fast.

So the request is this:  make the tutorial available in 
ONE html file so anybody can print it nicely with correct 
pagenumbers etc. from their browser.  This could also 
be interesting for the other documentation?
msg53838 - (view) Author: Jack Jansen (jackjansen) * (Python committer) Date: 2003-04-03 09:44
Logged In: YES 
user_id=45365

The tutorial is also available in PDF, but at the moment only if you download an archive containing the full documentation set (on the doc/current/download.html page).

Maybe it is a good idea to make the PDFs available separately too? The letter variation is probably best, non-americans are more used to letter than americans to A4, I guess...
msg53839 - (view) Author: Joost Jacob (wspace) Date: 2003-04-03 09:54
Logged In: YES 
user_id=697662

Jack Jansen mentions availability of PDF files, but I did not 
find those on the Python web site when I was (in a hurry) 
looking for the tutorial.  Also he mentions "Letter" or "A4" 
variations, but this is one of the reasons I think one HTML file 
would be best for each document: the users' browser can 
print that to postscript or send it directly to a printer with all 
the users' favorite options.
msg53840 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2003-05-12 17:57
Logged In: YES 
user_id=80475

The PDF and PostScript formats are better suited to 
printing out booklets.  Let us know if these links meet your 
needs:

http://www.python.org/doc/current/download.html
msg53841 - (view) Author: Jack Jansen (jackjansen) * (Python committer) Date: 2003-05-18 20:12
Logged In: YES 
user_id=45365

Raymond,
I think that the real complaint is "you cannot print the tutorial without 
downloading the full documentation set". I think this is a valid complaint: it's 
a bit silly to have to download and unpack the whole set only to print a 
single document.

My suggestion would be to add a (pdf) link to each of the lines that point to 
the various HTML documentation sections.

If you really don't agree feel free to set the state to closed/invalid again.
msg53842 - (view) Author: Joost Jacob (wspace) Date: 2003-05-18 21:08
Logged In: YES 
user_id=697662

Ah...latests messages are listed high.  I didn't know and was 
reading the bottom (nothing new).
I am the Original Poster (OP) and Jack is right about the 
OP's "real complaint".  I wanted to print the tutorial fast, from 
HTML or PDF preferably.  I would like to add I do not like the 
word complaint for this, Python is open source, and I am very 
happy with any docs there are.
msg55184 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2007-08-23 19:10
Assigning to me to remind myself about writing a PDF-producing Sphinx
builder.
msg59382 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2008-01-06 15:20
Which is now done.
History
Date User Action Args
2022-04-10 16:08:01adminsetgithub: 38258
2008-01-06 15:20:58georg.brandlsetstatus: open -> closed
resolution: fixed
messages: + msg59382
2007-08-23 19:10:43georg.brandlsetassignee: georg.brandl
resolution: not a bug -> (no value)
messages: + msg55184
nosy: + georg.brandl
2003-04-03 09:01:15wspacecreate