Status on HgBook
Martin Geisler
mg at aragost.com
Fri Nov 5 13:37:31 UTC 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