Status on HgBook

[anton]

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.
>