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: Create epub format docs and offer them on the download page
Type: enhancement Stage: patch review
Components: Versions: Python 3.2
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: georg.brandl Nosy List: brett.cannon, eric.araujo, georg.brandl, sandro.tosi, wrobell
Priority: deferred blocker Keywords: patch

Created on 2010-10-17 11:32 by georg.brandl, last changed 2022-04-11 14:57 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
issue10130-py3k.patch sandro.tosi, 2010-12-25 13:15
issue10130_part2-py3k.patch sandro.tosi, 2010-12-25 22:59
issue10130-v2-py3k.patch sandro.tosi, 2011-01-01 15:37
Messages (6)
msg124635 - (view) Author: Sandro Tosi (sandro.tosi) * (Python committer) Date: 2010-12-25 13:15
Hi,
with the attached patch (quite easy honestly ;)) we can generate an EPUB.

I don't have a real e-book reader to test it on, but I used calibre (and its viewer) and the file is usable, and the cross-reference links works just fine; there are some CSS effects that are not shown (like the color in some boxes, like See also sections and so), but at least we have something to work with :)

What do you think would be the next steps?

Cheers,
Sandro
msg124645 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2010-12-25 19:26
The next step is publishing these epubs and waiting for the resulting flood of bug reports :)
msg124652 - (view) Author: Sandro Tosi (sandro.tosi) * (Python committer) Date: 2010-12-25 22:59
ah great, 'bugs-generator' is my middle name :)

If I got it right, I've prepared another patch to add the archives generation in Doc/makefile (for dist target) and then add them to the download page.

Just let me know if I missed something, I'm still learning
msg125001 - (view) Author: Sandro Tosi (sandro.tosi) * (Python committer) Date: 2011-01-01 15:37
Hi, I've updated the patch, to also mention the 'epub' target in Dco/README.txt but mainly to fix an HTML error in indexcontent.html that prevents the epub to be correctly generated.
msg125416 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2011-01-05 11:00
Thanks, I've committed this as r87760 and r87761.
msg128636 - (view) Author: wrobell (wrobell) Date: 2011-02-16 09:48
it would be nice to have some short TOC at the beginning.

at the moment, one has to scroll through several pages of "what's new in python [23].[0-9]" table of contents until he/she gets into tutorial.
History
Date User Action Args
2022-04-11 14:57:07adminsetgithub: 54339
2011-02-16 09:48:35wrobellsetnosy: + wrobell
messages: + msg128636
2011-01-05 11:00:43georg.brandlsetstatus: open -> closed

messages: + msg125416
resolution: fixed
nosy: brett.cannon, georg.brandl, eric.araujo, sandro.tosi
2011-01-01 15:37:45sandro.tosisetfiles: + issue10130-v2-py3k.patch
nosy: brett.cannon, georg.brandl, eric.araujo, sandro.tosi
messages: + msg125001
2010-12-25 22:59:31sandro.tosisetfiles: + issue10130_part2-py3k.patch
nosy: brett.cannon, georg.brandl, eric.araujo, sandro.tosi
messages: + msg124652
2010-12-25 19:26:24georg.brandlsetnosy: brett.cannon, georg.brandl, eric.araujo, sandro.tosi
messages: + msg124645
2010-12-25 13:15:26sandro.tosisetfiles: + issue10130-py3k.patch

nosy: + sandro.tosi
messages: + msg124635

keywords: + patch
stage: patch review
2010-10-17 18:01:53brett.cannonsetnosy: + brett.cannon
2010-10-17 15:50:30eric.araujosetnosy: + eric.araujo
2010-10-17 11:32:48georg.brandlcreate