Status on HgBook
anton
antonxx at gmx.de
Thu Nov 4 15:46:29 UTC 2010
You mean you want to uye Sphinx
to create the new book?
(like the official python doc)
Martin Geisler wrote:
> Marko Käning <mk362 at mch.osram.de> writes:
>
>> Hi Martin,
>>
>> I'd also hesitate to go so easily from DocBook to ReST, since XML
>> might be a pain to edit (without the right tools!), but it is
>> definitely better if you want to process it further, like e.g. giving
>> it to a publisher (as pointed out by Augie), or converting it into
>> HTML, LaTeX or whatever else.
>
> I disagree about Docbook being better -- I hate it when I pickup an
> O'Reilly book with its bland and boring layout... Docbook does not make
> beautiful books in my experience.
>
> Postprocessing the XML tree in Docbook or the XML tree Docutils can
> output should be the same. It's just that one of the input formats is
> for humans who like plain text (me) and the other is for robots :)
>
>> I do admit that I don't know ReST, but I can imagine that DocBook
>> could have more features for the purpose of documentation
>> (structuring, referencing, etc.), but I might be wrong.
>
> I don't know -- I just know that I don't like Docbook input.
>
More information about the Mercurial
mailing list