Re: Weblate Translation Tips

On Sun, Aug 8, 2021 at 6:47 PM Danilo G. Baio <dbaio@freebsd.org> wrote:
>
>
>
> On Sun, Aug 8, 2021, at 13:41, Fernando Apesteguía wrote:
> > El dom., 8 ago. 2021 18:36, Danilo G. Baio <dbaio@freebsd.org> escribió:
> >
> > >
> > >
> > > On Sun, Aug 8, 2021, at 11:09, Fernando Apesteguía wrote:
> > > > On Sat, Aug 7, 2021 at 9:24 PM Danilo G. Baio <dbaio@freebsd.org> wrote:
> > > > >
> > > > > Hi.
> > > > >
> > > > > As you may know, we are still adjusting the translation workflow of the
> > > > > FreeBSD Documentation Project through Weblate, there are some pending
> > > > > items [1], but everyone can [re-]start translating.
> > > > >
> > > > > I've just added this wiki page [2] describing how to translate/build
> > > > > each document (for now, there are only three).
> > > > >
> > > > > The 'Article / Contributors to FreeBSD' [3] is a good example that
> > > every
> > > > > language should follow to keep all contributor's names updated.
> > > > >
> > > > > If you have any questions, please let us know.
> > > >
> > > > Hi Danilo,
> > > >
> > > > Thanks for this. It is very helpful!
> > > >
> > > > Some questions. In the example on how to update the "Contributors to
> > > > FreeBSD" article, it is said: "Just necessary translate index and
> > > > contrib-develinmemoriam."
> > > > In es/ we do not have any contributors/ directory. Not a big deal, we
> > > > can create a new one based on another language. But here is the
> > > > question. If we compare the directories pt_BR/ and en/:
> > > >
> > > >  ls ../../../en/articles/contributors/
> > > > _index.adoc                   contrib-386bsd.adoc
> > > > contrib-additional.adoc       contrib-committers.adoc
> > > > contrib-corealumni.adoc       contrib-develalumni.adoc
> > > > contrib-develinmemoriam.adoc  contrib-portmgralumni.adoc
> > > >
> > > > $ ls ../../../pt-br/articles/contributors/
> > > > _index.adoc                   _index.po
> > > > contrib-develinmemoriam.adoc  contrib-develinmemoriam.po
> > > >
> > > > Should I base the new "Contributors" article in the English version or
> > > > another one?
> > > >
> > > > Thanks!
> > >
> > >
> > > Hi Fernando.
> > >
> > > In this case, you can follow pt-br; the missing files are
> > > referenced/included
> > > directly from the English directory.
> > >
> > > include::content/en/articles/contributors/contrib-committers.adoc[]
> > > include::content/en/articles/contributors/contrib-corealumni.adoc[]
> > > include::content/en/articles/contributors/contrib-develalumni.adoc[]
> > > include::content/en/articles/contributors/contrib-portmgralumni.adoc[]
> > > include::{include-path}contrib-develinmemoriam.adoc[]
> > > include::content/en/articles/contributors/contrib-additional.adoc[]
> > > include::content/en/articles/contributors/contrib-386bsd.adoc[]
> > >
> > > You have to change this manually after translating with
> > > ./tools/translate.sh.
> > >
> >
> > Oops, yes. It was there in the wiki!
> >
> > Thanks for the clarification!
>
>
> Ah, don't worry. If you note something that is not there, let us know. or just update the wiki page  :)

At the risk of exhausting your patience... :-)

I tried to follow the guide, and got stuck running the translate.sh script:

$ ./tools/translate.sh documentation es
.....
documentation/content/es/articles/contributors/_index.po
Your input po file
documentation/content/es/articles/contributors/_index.po seems
outdated (The amount of entries differ between files: 73 is not 74
). Please consider running po4a-updatepo to refresh it.
.....
documentation/content/es/articles/contributors/contrib-develinmemoriam.po

I did the copy as the guide suggested in very updated freebsd-doc and
freebsd-doc-translate repos and nevertheless repeated the process, but
po4a-translate always complains about the number of entries mismatch.

As a side note, I finished the Spanish translation of
articles/contributors in Weblate. After a few minutes, I pulled the
changes in freebsd-doc-translate. If I continue translating with
weblate and pull the changes in my local copy of
freebsd-doc-translate, can I use that as base to do the copy to
freebsd-doc? Of course I need to translate the other documents
(contrib-*.po).

Cheers




>
> Thanks.
> --
> Danilo G. Baio