Translation of git manpages
- Date: Mon, 07 Jan 2019 21:45:12 +0100
- From: Jean-Noël AVILA <jn.avila@xxxxxxx>
- Subject: Translation of git manpages
Dear fellow translators,
I'm trying to put up a longstanding project of providing translated manual
pages for Git. After several experiments, the best choice seemed to be the use
of po4a to convert the asciidoc sources of git manpages into po files
that could be processed the same way we are already doing for the translation
of Git itself.
The text is segmented into paragraphs and structural units (titles, list
items...) and when translated, they are reinjected into the original text
structure. Only inline asciidoc formatting marks are passed in segments.
The translation takes place in a dedicated repository . It simpler to not
meddle in git main workflow while adjusting the translation workflow. If
everybody is satisfied with it, we can maybe migrate the repo under git
organization. Now, this repo is standalone with respect to translation content
source, but a patch has been submitted so that the translated manpages can be
generated and installed from the main git project. Symmetrically, there's a
script in the project to pull the manpages source files from the main git repo.
The repository is connected to Weblate if you have collaborators who don't
know how to process po files and prefer translating in the browser.
The repository is also open to pull-request on the tooling. Let me know if you
have issues. In any case, the translation work can be reused for any other
There is already a kernel of translation in French, from my experiments and a
previous effort of German translation was gettextized. If you have such
archives for other languages, I'd be happy to integrate them, even if they are
not up to date.