From nobody Sun Aug 22 18:15:40 2021 X-Original-To: freebsd-translators@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id BD781177C829 for ; Sun, 22 Aug 2021 18:16:11 +0000 (UTC) (envelope-from dbaio@FreeBSD.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Gt3Tl4jVFz3kQg; Sun, 22 Aug 2021 18:16:11 +0000 (UTC) (envelope-from dbaio@FreeBSD.org) Received: from auth2-smtp.messagingengine.com (auth2-smtp.messagingengine.com [66.111.4.228]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) (Authenticated sender: dbaio/mail) by smtp.freebsd.org (Postfix) with ESMTPSA id 85DA04680; Sun, 22 Aug 2021 18:16:11 +0000 (UTC) (envelope-from dbaio@FreeBSD.org) Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailauth.nyi.internal (Postfix) with ESMTP id 3A0DC27C0054; Sun, 22 Aug 2021 14:16:11 -0400 (EDT) Received: from imap42 ([10.202.2.92]) by compute4.internal (MEProxy); Sun, 22 Aug 2021 14:16:11 -0400 X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvtddruddtfedguddvfecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmd enucfjughrpefofgggkfgjfhffhffvufgtgfesthhqredtreerjeenucfhrhhomhepfdff rghnihhlohcuifdruceurghiohdfuceouggsrghioheshfhrvggvuefuffdrohhrgheqne cuggftrfgrthhtvghrnhepledtvdejgeefjeejvedvtdevgeethfevudejleelteeukeff veffveejvefgffeunecuffhomhgrihhnpehfrhgvvggsshgurdhorhhgnecuvehluhhsth gvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepuggsrghiohdomhgvshhm thhprghuthhhphgvrhhsohhnrghlihhthidquddukedufeeluddvtddqvdeikedtvdejie ekqdgusggrihhopeephfhrvggvuefuffdrohhrghesfhgrshhtmhgrihhlrdgtohhm X-ME-Proxy: Received: by mailuser.nyi.internal (Postfix, from userid 501) id 124C82180066; Sun, 22 Aug 2021 14:16:11 -0400 (EDT) X-Mailer: MessagingEngine.com Webmail Interface User-Agent: Cyrus-JMAP/3.5.0-alpha0-1118-g75eff666e5-fm-20210816.002-g75eff666 List-Id: Translators List-Archive: https://lists.freebsd.org/archives/freebsd-translators List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-translators@freebsd.org X-BeenThere: freebsd-translators@freebsd.org Mime-Version: 1.0 Message-Id: In-Reply-To: References: <20210807192422.6w5ful3tionb4r5i@t480.local> <8a84fbfa-49c1-495f-8cc0-9d71a1aa096e@www.fastmail.com> <1b9b4bb8-75c7-454d-a726-1b010fd30a90@www.fastmail.com> Date: Sun, 22 Aug 2021 15:15:40 -0300 From: "Danilo G. Baio" To: =?UTF-8?Q?Fernando_Apestegu=C3=ADa?= Cc: freebsd-translators@freebsd.org Subject: Re: Weblate Translation Tips Content-Type: text/plain;charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam: Yes X-ThisMailContainsUnwantedMimeParts: N 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 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 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 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