Date: Sun, 22 Aug 2021 15:15:40 -0300 From: "Danilo G. Baio" <dbaio@FreeBSD.org> To: =?UTF-8?Q?Fernando_Apestegu=C3=ADa?= <fernando.apesteguia@gmail.com> Cc: freebsd-translators@freebsd.org Subject: Re: Weblate Translation Tips Message-ID: <bcd02893-526f-4080-b654-79e80f826f79@www.fastmail.com> In-Reply-To: <CAGwOe2Z5WR_O=%2BKbvM01ecAmpCOrAXJdxnnbUz8Q51E_vYs44Q@mail.gmail.com> References: <20210807192422.6w5ful3tionb4r5i@t480.local> <CAGwOe2bxJDYVda_77j%2BujQ1rHf8mxOHF2gVW4TnwQxpnVM9GkQ@mail.gmail.com> <8a84fbfa-49c1-495f-8cc0-9d71a1aa096e@www.fastmail.com> <CAGwOe2b1mBuMfND1BAV=d9heyH6sPMK7C0sG8b8gNJ0xHOzQZA@mail.gmail.com> <1b9b4bb8-75c7-454d-a726-1b010fd30a90@www.fastmail.com> <CAGwOe2Z5WR_O=%2BKbvM01ecAmpCOrAXJdxnnbUz8Q51E_vYs44Q@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sun, Aug 22, 2021, at 11:33, Fernando Apestegu=C3=ADa wrote:
> On Sun, Aug 8, 2021 at 6:47 PM Danilo G. Baio <dbaio@freebsd.org> wrot=
e:
> >
> >
> >
> > On Sun, Aug 8, 2021, at 13:41, Fernando Apestegu=C3=ADa wrote:
> > > El dom., 8 ago. 2021 18:36, Danilo G. Baio <dbaio@freebsd.org> esc=
ribi=C3=B3:
> > >
> > > >
> > > >
> > > > On Sun, Aug 8, 2021, at 11:09, Fernando Apestegu=C3=ADa wrote:
> > > > > On Sat, Aug 7, 2021 at 9:24 PM Danilo G. Baio <dbaio@freebsd.o=
rg> wrote:
> > > > > >
> > > > > > Hi.
> > > > > >
> > > > > > As you may know, we are still adjusting the translation work=
flow of the
> > > > > > FreeBSD Documentation Project through Weblate, there are som=
e pending
> > > > > > items [1], but everyone can [re-]start translating.
> > > > > >
> > > > > > I've just added this wiki page [2] describing how to transla=
te/build
> > > > > > each document (for now, there are only three).
> > > > > >
> > > > > > The 'Article / Contributors to FreeBSD' [3] is a good exampl=
e that
> > > > every
> > > > > > language should follow to keep all contributor's names updat=
ed.
> > > > > >
> > > > > > 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 "Contribut=
ors 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 d=
eal, 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 ve=
rsion 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.ado=
c[]
> > > > include::content/en/articles/contributors/contrib-corealumni.ado=
c[]
> > > > include::content/en/articles/contributors/contrib-develalumni.ad=
oc[]
> > > > include::content/en/articles/contributors/contrib-portmgralumni.=
adoc[]
> > > > include::{include-path}contrib-develinmemoriam.adoc[]
> > > > include::content/en/articles/contributors/contrib-additional.ado=
c[]
> > > > 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 kno=
w. or just update the wiki page :)
>=20
> At the risk of exhausting your patience... :-)
>=20
Hi Fernando.
Not at all. This is good to improve instructions.
You and everyone can ask anything. It's good to see that more people are=
translating FreeBSD documents.
> I tried to follow the guide, and got stuck running the translate.sh sc=
ript:
>=20
> $ ./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
>=20
You can use this variable/env so po4a-translate will ignore the translat=
ion percentage:
$ KEEP_ENV=3D0 ./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 no=
t 74
). Please consider running po4a-updatepo to refresh it.
.....
documentation/content/es/articles/contributors/contrib-develinmemoriam.po
$ find documentation/content/es/articles/contributors/
documentation/content/es/articles/contributors
documentation/content/es/articles/contributors/contrib-develinmemoriam=
.adoc
documentation/content/es/articles/contributors/_index.po
documentation/content/es/articles/contributors/_index.adoc
documentation/content/es/articles/contributors/contrib-develinmemoriam=
.po
I'll update the wiki instructions later with the KEEP_ENV=3D0.
> 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.
>=20
> 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).
>=20
> Cheers
Yes, you can use it.
Last update on Weblate is from 2021-07-25 [1].
There was only one change on articles/contributors [1] since that. It's=
a single '+', just check/include that.
1 - https://cgit.freebsd.org/doc/commit/?id=3Dd369054ed343acb84f1091d5a6=
76c1039ed62d76
2 - https://cgit.freebsd.org/doc/commit/documentation/content/en/article=
s/contributors/_index.adoc?id=3Da5d0b55b2fc7761041a0bb115eefdb10ff0f8af0
Regards.
--=20
Danilo G. Baio
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bcd02893-526f-4080-b654-79e80f826f79>