On 2011-12-01, Bob Plantz wrote: > I am converting a textbook I have written in LaTeX to epub. The book > (500+ pages) is on assembly language. It has many drawings (vector > graphics), a fair amount of math equations (but only simple algebra > notation), and many code listings. My goal is to make it available > both in epub (for ereaders) and pdf (for printing).
> So far I have been converting the source to rst and using docutils for > producing the two versions of the book. I have learned how to include > different versions of the figures in the final product: svg for epub; > eps for pdf (via LaTeX). Common html seems to be adequate for my > equations, and the code listings look good (although I would like to > be able to add line numbering). > Does Sphinx offer advantages for such a project over "raw" docutils? * Document splitting and cross-referencing. * Special roles and directives for code documentation (may be not required by your project) * ready-made epub extension. IMV, Sphinx is the better choice for large projects (web sites ...) while Docutils is for "stand-alone" documents. BTW: In the development version, Docutils now also supports syntax highlight with a "code" directive and role. Since version 0.8, math is supported. > Keep in mind that I'm an assembly language programmer. In other words, > sort of a control freak. I don't like programs that have a mind of > their own, for example, MS Word. Both, Sphinx and Docutils offer comprehensive configuration options and can also be used programatically. > Yes, this is lots of work. But I'm retired, and the problem of > publishing technical books in epub interests me. Good way to keep my > mind active. We had some discussion about the missing parts for scientific writing with reStructuredText here as well as on the docutils list (citation/reference support, epub intergration, footnotes, ...). There is plenty of work and of food for thought :-) Günter -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to sphinx-dev@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.
