From nobody Mon Aug 23 20:10:25 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 6240E1797C4C for ; Mon, 23 Aug 2021 20:10:38 +0000 (UTC) (envelope-from fernando.apesteguia@gmail.com) Received: from mail-yb1-xb2f.google.com (mail-yb1-xb2f.google.com [IPv6:2607:f8b0:4864:20::b2f]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4GtjzL1JlPz3vBy; Mon, 23 Aug 2021 20:10:38 +0000 (UTC) (envelope-from fernando.apesteguia@gmail.com) Received: by mail-yb1-xb2f.google.com with SMTP id q70so20245720ybg.11; Mon, 23 Aug 2021 13:10:38 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=E0GrmqMnPLWXW07eGl+lAM32+bVcI9A88gEKZR6lWMc=; b=o3wKUWeW8QXZxwecu00L+cv9vxyjQ3dPD9/YY42q8JScXcejGZ82GrOlGZKGBU4/yL sEfwAXnYrJwziRSWpIwMPiVA8oOLuwYxjJwLAIDLTlA2tqEWWZYirUyKAULYBDT5ali6 fksC75gpM1ME0BsGbDyoSrLPCQsQdDOHOhBNRbTQFL1ox7XYhOmB/FhqOrirjs2Nk0NR RpcmH2rdgBzt253U4IiF38nIYHM6jj4w+EmniSJh6Og9y0zO7wiPAK1NwyPv9XWZmYMy ptPSy3i6yVYeqyp3wBl1siw7t/q+Z44GWdqvbzwtXwRIJq3zURjHp6dCLpOlGULBdWbX fsdw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=E0GrmqMnPLWXW07eGl+lAM32+bVcI9A88gEKZR6lWMc=; b=h+5NNrraF7TKTWIN/q80hpj7FjR/uGG/XD7gGYBgRzc5bCrMtiPKS4bv5T6e9BUAU6 n5fffx/TO/KtepXLm7gJcwvYNJEsPB+qTrI9wdpZa0UCqK4h1XiTtxLbWiSg6QjHTGES X1uB6/KxmGLU1ohat3ZTJmTV3/aRmr8ni2DzOfK29nRFdc68tXUAjdyUHEsHpBMb6yP/ Z5W/arz3Uu/6U0+5hext/SuGSM5dV7FNueKypxhFzg2Wm2W5kxe0yu+2di/iMkAN+6QY h4DOBbeWkewPXIiMovFyBA0Irv9iPId+JbuE6VxmAIVjZPStyE+rPP2tE+sjgVz9rGoP JRMw== X-Gm-Message-State: AOAM530x8OtnVruN05RftPIGgW+DD7Z/ooBXZK9Ajr1ykVakgHaND6mD CAzcTpMOzEm99ELy73NzYyUrL0990cxPKpcMu980gBn+ X-Google-Smtp-Source: ABdhPJw+luev/WkfHpLkfhZR0agsSlYuaTgVh3CzZPa/XL0SA5GlcuUx2HhXbxn4DY6GoH0+yT2bYVb+aVZ2Nkie8Ig= X-Received: by 2002:a05:6902:1144:: with SMTP id p4mr47053786ybu.418.1629749437535; Mon, 23 Aug 2021 13:10:37 -0700 (PDT) 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 References: <20210807192422.6w5ful3tionb4r5i@t480.local> <8a84fbfa-49c1-495f-8cc0-9d71a1aa096e@www.fastmail.com> <1b9b4bb8-75c7-454d-a726-1b010fd30a90@www.fastmail.com> In-Reply-To: From: =?UTF-8?Q?Fernando_Apestegu=C3=ADa?= Date: Mon, 23 Aug 2021 22:10:25 +0200 Message-ID: Subject: Re: Weblate Translation Tips To: "Danilo G. Baio" Cc: freebsd-translators@freebsd.org Content-Type: multipart/alternative; boundary="0000000000004c190805ca3f9cfc" X-Rspamd-Queue-Id: 4GtjzL1JlPz3vBy X-Spamd-Bar: ---- Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; TAGGED_FROM(0.00)[] X-Spam: Yes X-ThisMailContainsUnwantedMimeParts: N --0000000000004c190805ca3f9cfc Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable El lun., 23 ago. 2021 20:51, Danilo G. Baio escribi=C3= =B3: > > > On Sun, Aug 22, 2021, at 15:32, Fernando Apestegu=C3=ADa wrote: > > On Sun, Aug 22, 2021 at 8:16 PM Danilo G. Baio > wrote: > > > > > > > > > > > > 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 > wrote: > > > > > > > > > > > > > > > > > > > > On Sun, Aug 8, 2021, at 13:41, Fernando Apestegu=C3=ADa wrote: > > > > > > El dom., 8 ago. 2021 18:36, Danilo G. Baio > escribi=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.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 bi= g > 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... :-) > > > > > > > > > > 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 > 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 > > > > > > > > > > > > > You can use this variable/env so po4a-translate will ignore the > translation 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 not 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.a= doc > > > documentation/content/es/articles/contributors/_index.po > > > documentation/content/es/articles/contributors/_index.adoc > > > > documentation/content/es/articles/contributors/contrib-develinmemoriam.p= o > > > > > > > > > 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 a= nd > > > > freebsd-doc-translate repos and nevertheless repeated the process, > but > > > > po4a-translate always complains about the number of entries mismatc= h. > > > > > > > > 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 > > > > > > 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=3Dd369054ed343acb84f1091d5a676c10= 39ed62d76 > > > 2 - > https://cgit.freebsd.org/doc/commit/documentation/content/en/articles/con= tributors/_index.adoc?id=3Da5d0b55b2fc7761041a0bb115eefdb10ff0f8af0 > > > > Thank you very much! It's been really clarifying. > > > > I see in contributors/_index.adoc we are including documents from en/ > > e.g. the list of additional contributors. These files are made purely > > of names and email addresses that do not need translation. In Weblate, > > these appear as untranslated documents. With this workflow, I > > understand we will never want to translate those files, right? > > Including them, guarantees that the list of contributors, additional > > contributors, etc is always in sync with the master (aka English) > > version. > > > > Should we somehow disable those documents in Weblate? I see the > > Manage->Removal option, but I was thinking more in terms of "locking" > > the document and showing the translator a message about how those > > files are included. I didn't see anything like that on Weblate. > > > > Good point. > > I've removed them from the Weblate git repository [1]. All components are > gone. > > Weblate is in sync with aefc57f944a16682bf48e67142451fca5acd2bde now. > Great! Thanks :-) > > 1 - > https://cgit.freebsd.org/doc/commit/?id=3Daefc57f944a16682bf48e67142451fc= a5acd2bde > > https://github.com/doc-br/freebsd-doc-translate/commit/17f5b5d30b428dbbb2= 7819f91899873f9f5a939f > > Regards. > -- > Danilo G. Baio > --0000000000004c190805ca3f9cfc--