From fernando.apesteguia at gmail.com Mon Apr 5 14:38:53 2021 From: fernando.apesteguia at gmail.com (=?UTF-8?Q?Fernando_Apestegu=C3=ADa?=) Date: Mon, 5 Apr 2021 16:35:29 +0200 Subject: Committing in Weblate and sending po Message-ID: Hi! It's me again, sorry ;-) Reading the doc in https://wiki.freebsd.org/DocTranslationOnWeblate, it looks like I should have a "Manage" tab in weblate so I can commit a change and that would trigger a CI build. But I don't see that tab. I am not in a hurry, I can wait for the daily build run. But just in case there is something that I am missing. The other thing is that in the wiki we point to this document on how to submit translations: https://docs.freebsd.org/en/books/fdp-primer/po-translations-submitting.html It looks outdated and also I could not find any .po files in the docs repository. So I wonder if there is a different method to add a new translation to the repository. I assume I should create a new directory in documentation/content/es/articles/ and put the _index.adoc there. But how do I generate the _index.adoc from the .po I can download from weblate? Thanks! From dbaio at FreeBSD.org Mon Apr 5 15:09:07 2021 From: dbaio at FreeBSD.org (Danilo G. Baio) Date: Mon, 5 Apr 2021 12:09:03 -0300 Subject: Committing in Weblate and sending po In-Reply-To: References: Message-ID: <20210405150903.cbl6dkp72n2p7usi@t480.local> On Mon, Apr 05, 2021 at 04:35:29PM +0200, Fernando Apestegu?a wrote: > Hi! > > It's me again, sorry ;-) > > Reading the doc in https://wiki.freebsd.org/DocTranslationOnWeblate, > it looks like I should have a "Manage" tab in weblate so I can commit > a change and that would trigger a CI build. But I don't see that tab. > I am not in a hurry, I can wait for the daily build run. But just in > case there is something that I am missing. hum, I'll look into this. > > The other thing is that in the wiki we point to this document on how > to submit translations: > > https://docs.freebsd.org/en/books/fdp-primer/po-translations-submitting.html > > It looks outdated and also I could not find any .po files in the docs > repository. So I wonder if there is a different method to add a new > translation to the repository. I assume I should create a new > directory in documentation/content/es/articles/ and put the > _index.adoc there. But how do I generate the _index.adoc from the .po > I can download from weblate? PO files were removed with the migration. I've opened two reviews. The first [1] adds helper scripts for generating/update PO files and to also translate documents with them. Is what we are using in our CI. The second [2] fix some outdated/wrong entries in the FDP. It's not a rewrite, but we will need that for chapters 'Translations' and 'PO Translations' at least. On [2] you will find the commands necessary to translate PO files to .adoc. Use the latest po4a-0.63_1, there is a patch on it to work with our documentation set. Regards. https://reviews.freebsd.org/D29569 https://reviews.freebsd.org/D29573 -- Danilo G. Baio (dbaio) -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 963 bytes Desc: not available URL: From dbaio at FreeBSD.org Mon Apr 5 16:03:46 2021 From: dbaio at FreeBSD.org (Danilo G. Baio) Date: Mon, 5 Apr 2021 13:03:43 -0300 Subject: Automatic Translations Message-ID: <20210405160343.vpkd7ca4qozhze7w@t480.local> Hi, just a heads up. We have made progress with 'Weblate Automatic Translation' feature and this will automate 'Translation based on Automatic Suggestions' [1]. The first round consists in translating/copying translations from the former project into the new one. Source strings that match 100% similarity will be copied to the new project, these strings will be marked as translated. This is already happening for a week, status: pt_BR - ok es - ok zh_CN - ok zh_TW - executing nl_NL - fr_FR - de_DE - it_IT - nb_NO - fa - tr_TR - After that we will execute a second round that will find source strings that match between 80% to 99% similarity, these strings will be marked as 'fuzzy' or 'needs editing' and will be waiting for review. Hope that help and speed the process for language teams that already translated a lot of things. The second round wasn't executed together with the first because this feature is not present on Weblate right now, it will be pushed into the next release. [2] For those who want to see/follow the automatic translation, look here [3]. Regards. 1 - https://wiki.freebsd.org/DocTranslationOnWeblate#Translation_based_on_Automatic_Suggestions 2 - https://github.com/WeblateOrg/weblate/pull/5764 3 - https://github.com/doc-br/freebsd-doc-weblate/commits/main https://translate-dev.freebsd.org/projects/documentation/#history -- Danilo G. Baio (dbaio) -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 963 bytes Desc: not available URL: From fernando.apesteguia at gmail.com Mon Apr 5 16:18:26 2021 From: fernando.apesteguia at gmail.com (=?UTF-8?Q?Fernando_Apestegu=C3=ADa?=) Date: Mon, 5 Apr 2021 18:15:03 +0200 Subject: Committing in Weblate and sending po In-Reply-To: <20210405150903.cbl6dkp72n2p7usi@t480.local> References: <20210405150903.cbl6dkp72n2p7usi@t480.local> Message-ID: On Mon, Apr 5, 2021 at 5:09 PM Danilo G. Baio wrote: > > On Mon, Apr 05, 2021 at 04:35:29PM +0200, Fernando Apestegu?a wrote: > > Hi! > > > > It's me again, sorry ;-) > > > > Reading the doc in https://wiki.freebsd.org/DocTranslationOnWeblate, > > it looks like I should have a "Manage" tab in weblate so I can commit > > a change and that would trigger a CI build. But I don't see that tab. > > I am not in a hurry, I can wait for the daily build run. But just in > > case there is something that I am missing. > > hum, I'll look into this. > > > > > The other thing is that in the wiki we point to this document on how > > to submit translations: > > > > https://docs.freebsd.org/en/books/fdp-primer/po-translations-submitting.html > > > > It looks outdated and also I could not find any .po files in the docs > > repository. So I wonder if there is a different method to add a new > > translation to the repository. I assume I should create a new > > directory in documentation/content/es/articles/ and put the > > _index.adoc there. But how do I generate the _index.adoc from the .po > > I can download from weblate? > > PO files were removed with the migration. > > I've opened two reviews. > > The first [1] adds helper scripts for generating/update PO files and to > also translate documents with them. Is what we are using in our CI. > > The second [2] fix some outdated/wrong entries in the FDP. It's not a > rewrite, but we will need that for chapters 'Translations' and 'PO > Translations' at least. > > On [2] you will find the commands necessary to translate PO files to > .adoc. > > Use the latest po4a-0.63_1, there is a patch on it to work with our > documentation set. Excellent. I'll have a look at this. Thanks! > > Regards. > > https://reviews.freebsd.org/D29569 > https://reviews.freebsd.org/D29573 > -- > Danilo G. Baio (dbaio)