On Wednesday, 6 March 2013 05:36:16 UTC+5:30, Timmie wrote:
>
> > In spite of these drawbacks I wrote a little advocacy article about 
> > Sphinx, because I think that Sphinx could become a really good multi 
> > channel publishing tool. 
> > 
> > http://www.hasecke.eu/Members/juh/sphinx-a-tool-for-self-publisher 
> Here's a similar article: 
>
> http://blog.dehlia.in/2010/11/professional-book-like-structure-with-sphinx/ 
>

Regarding formatting:  
 I do agree that there are some rough edges, but honestly 
 I have struggled a lot using Word and open office for formatting. 
 Tweaking Sphinx is still an easier choice for me. See my changes
 at https://bitbucket.org/poo/sphinx-eclipsebook/ 

Regarding other advantages like conditional inclusion of text with .. 
only::, etc. 
Sphinx clearly wins for me.  Rather than achieving the same using macros in
other tools, Sphinx is great utility.

Sphinx/reStructuredText can also be be used to create 
live technical documents. 
(live book ==> http://hgbook.red-bean.com/.  The contents of that book is 
generated 
from output of Mercurial. If the tool console output changes, book 
automatically gets 
updated.  This is also a big win for technical documents.).

In the long run, I definitely think that Sphinx would be de-facto choice 
for technical documents from broad spectrum.

Regarding your question about non-technical person using Sphinx, We already 
working on a framework for 
multi-channel distribution of books on top of Sphinx, Ratatouille [1]

Ratatouille is already partially functional, and there are some 
non-technical books already available to the end user.
We hope, that with handful of example books tutoring how a book is 
written/organized in Sphinx, non techincal
users would also switch to Sphinx.

[1] Ratatouille - Anyone can write and publish.  See 
blog announcement 
http://blog.dehlia.in/2013/03/ratatouille-anyone-can-write-and-publish/

--
Purnank. Co-Author of http://eclipsebook.in/ 
 

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sphinx-users?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to