Re: Translation of git manpages
- Date: Tue, 08 Jan 2019 14:54:36 +0100
- From: Ævar Arnfjörð Bjarmason <avarab@xxxxxxxxx>
- Subject: Re: Translation of git manpages
On Mon, Jan 07 2019, Jean-Noël AVILA wrote:
> 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.
Thanks. This has come up on list many times before and it's great to
have some movement on it.
I think a way to have early exposure of these to a lot more people would
be to have these on the git-scm.com site. Jeff knows more about the
build process there.
I see the general completion of French & German is at ~10%, but maybe
there's some pages that are fully translated already? We could then have
some UI or git-scm.com that allows you to switch between languages along
with some general overview page per-language.
Are the translations contributed through
that license-wise (Signed-off-by etc.) we'd eventually be able to
upstream in git.git?
It would be great to eventually have something we can build as part of
our build process, so e.g. Debian can have git-man-de similar to