Only a few people recommended to use Sphinx at the beginning of the year.
Sphinx has developed rather fast recently. I noted today that Sage has made a change from direct editing with LaTex to Sphinx. This is evident in William Stein's answer on 2nd April about Sage's tutorial
The tutorial is not a latex document anymore. It's an entirely different Sphinx document that can output pdf.
It suggests me that Sphinx may be at a level such that it is suitable for me.
Is Sphinx better than LaTex in writing manuals/books?
We wrote a book with sphinx but we had to tweak the tex file produced with a Python script.
Take a look at this thread, in the book building tool section
Here a some changes we made to the original LaTeX file:
We also made minor changes to book.cls and sphinx.sty
With all these tweaks, we are very happy with the result.
Well, there is at least one book printed using sphinx and rst2pdf
Some sample documents generated via sphinx and rst2pdf here:
http://freedrive.com/folder/236385
And here:
http://freedrive.com/folder/236380
Specially check the python library reference and the django book.
This is output from the development branch and has bugs (for example, the TOC is often on the wrong side of the page) which are being fixed.
I prefer Sphinx to Latex for writing manuals for two reasons:
A book, however, might be a different story. If I wanted to write a book that has only a printed and a pdf version and contains equations and citations I would go with Latex, because I think it is much more mature than reST and I find it easy to customize.
Btw. I have much more experience in using Latex.
It's better for creating reference documentation, not for writing books.
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With