Docs now converted to RST and up on ReadTheDocs
cedric.corazza at gmail.com
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 db2rst.py
> 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 http://www.bugzilla.org/docs/ . You should file a bug in
> Bugzilla::bugzilla.org 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 lists.mozilla.org
More information about the developers