Daily my development is with Django and it was great to find that the documentation, which is built with Sphinx, can easily generate very nice epub output like this:
Here's how to generate your own:
pip install -U sphinx
svn co http://code.djangoproject.com/svn/django/trunk/ djangosvn
cd djangosvn/docs
make epub
The only thing missing is a cover image.
For your convenience, I've stuck a copy here.
Update: built Python 2.7 doc as epub
After that success I had a shot at building the Python documentation. The sphinx that comes with the python source is old and doesn't include the epub builder so I used a separate sphinx. All seemed to go well:
Here's the command line:
sphinx-build -b epub -d build/doctrees . build/epub
The output looks excellent on an iPad, it's 3,943 pages at normal font size and the iPad does groan a little but it is quite usable. epub is much much better than pdf for reading on tablets.
3 comments:
the post is very useful and save me a lot of time. thank you very much.
Thanks a lot !
thank you very much, great material!
Post a Comment