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
![Django.png](http://lh5.ggpht.com/_uT-6DNNXTO4/TKrl3R0tc5I/AAAAAAAAVPI/JGud-o2BxW0/Django.png?imgmax=800)
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:
![epub build.png](http://lh6.ggpht.com/_uT-6DNNXTO4/TKrk5rgxBhI/AAAAAAAAVPA/UUUGOK6EZB8/epub%20build.png?imgmax=800)
Here's the command line:
sphinx-build -b epub -d build/doctrees . build/epub
![python.png](http://lh6.ggpht.com/_uT-6DNNXTO4/TKrmD2pQd6I/AAAAAAAAVPU/5ESW2QUSq9s/python.png?imgmax=800)
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