Hi Gour. Can't help you much, see below.
[...] > When we were considering to code the project in Python, using > reST/Sphinx seemed be logical choise, but now we stumbled upon few > projects using AsciiDoc and wonder how would you compare it with > reST/Sphinx? Only used ReST on one project, prefer asciidoc, but there isn't much in it. IIRC the same project needs a large block of scripts tuning the latex to get the output it wants for its newsletter from the Rest source. But submissions are up since switching from latex input to rest. > > We want format which is friendly for keeping under DVCS, easy for > writing with the ability to get nice HTML output which can be invoked > from within application itself, as well as quality PDF output (possibly > to be tweaked and/or imported into LyX). Found Lyx gets indigestion when fed latex it didn't write, so I'd be wary of that path. And hand tuning is not the way to go, you need to push a button (well type a command) and get all the output formats in one go. > [...] > one is not forced to deal with Docbook format, although we wonder how > easy/stable/supported is the toolchain in order to produce desire output > formats? Docbook pdf tool chains vary in their quality and portability, but you do have a choice. Simple/common configuration requires you to RTFM to find out how, but are documented. Configuring complex things is potentially difficult but should be possible with both toolchains. > > It seems that reST/Sphinx is more simpler? Never used Sphinx so I can't comment, but you are now sole source. > > At the end, let me say that Linux is our native developing platform, but > we want to be able generate docs on Windows & Mac OS without too much > fiddling. I havn't tried it but FOP is Java and should run on any platform. Cheers Lex -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/asciidoc?hl=en.
