Status on HgBook

Martin Geisler mg at aragost.com
Fri Nov 5 08:37:31 CDT 2010


Glenn Hutchings <zondo42 at gmail.com> writes:

> On Nov 4, 1:33 pm, Martin Geisler <m... at aragost.com> wrote:
>> I want to do two things:
>>
>> 1. convert the book from the ugly Docbook XML syntax to ReST syntax,
>>    which I find more light-weight. That makes it easier for both the
>>    editors and the translators.
>
> If you mean reStructuredText, you may want to check out
> http://bitbucket.org/zondo/hgbook-sphinx. This is a conversion of the
> original LaTeX sources into RST, using a hacked version of the
> original Python docs converter script. (I suggested this RST/Sphinx
> option to Bryan at the time, but he'd decided to go with XML by then.)
> I'm not sure that continuing from the hgbook-sphinx repo would be a
> good thing: there's more content added in the XML since the LaTeX
> version, and in the long run it's probably easier to write a new
> converter from the XML. But it does give you a little preview of what
> it might look like.

Okay, thanks for the pointer!

However, having looked at bit at Bryan's Docbook files, I may have
changed my mind about the markup being ugly... it's certainly verbose,
but nicely structured after all.

Using that as a starting point would mean that we don't have to rebuild
the whole infrastructure again, we just need to get all the translations
migrated to Gettext like the Chinese translation.

-- 
Martin Geisler

aragost Trifork
Professional Mercurial support
http://aragost.com/mercurial/


More information about the Mercurial mailing list