Docs now converted to RST and up on ReadTheDocs

Cédric Corazza cedric.corazza at
Sat Jan 18 20:39:36 UTC 2014

Le 17/01/2014 13:00, Gervase Markham a écrit :
> Converting them to the new system: one option is to use the
> and makebzdocs tools here, which I used to do the initial conversion:
> There's then quite a bit of fixup to do, which I did manually. I'm
> afraid I didn't keep records of exactly what I did :-( The other option
> is to take the new English docs and copy-paste each para of French into
> the structure, but that might be more work.

I succeeded to convert the French documentation files almost flawlessly 
in an afternoon with the script on your repository. I just have now to 
get used to the RST syntax and fix some little remaining syntax errors. 
Will blog about this tomorrow with the link to the fr Documentation.

> As for putting them on ReadTheDocs, there's a FAQ answer:
> They want to have full language support, but it's not there yet.
> (Patches welcome? :-) In the mean time, the FAQ suggests creating a
> project for each language of documentation. So we would have:
> etc. and point each of them at the place where you keep your translation
> of the docs. Although RTD doesn't support CVS - only Git, SVN, BZR and
> Hg - so you'd need to move the Bugzilla docs somewhere else, or use
> Subversion SVN.

I migrated my CVS repository to Mercurial and will look at the FAQ on RTD.

> I note that we only have very old non-English versions of docs linked
> from . You should file a bug in
> to get that fixed.

I didn't notice that page. I will file a bug after hosting the 
up-to-date localized doc on my site. Probably tomorrow.


dev-apps-bugzilla mailing list
dev-apps-bugzilla at

More information about the developers mailing list