Weblate [FreeBSD WIKI]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Translate FreeBSD on Weblate ======

See [[https://docs.freebsd.org/en/books/fdp-primer/weblate/|books/fdp-primer/Weblate Translations]] chapter.

===== Status =====

After the migration of the Website and Documentation to Hugo and %%AsciiDoctor%% was necessary to lock the Weblate project to convert the current workflow to the new format.

^ Item ^ Responsible ^ Status ^ Note ^
| Weblate project for Documentation | [[/DaniloBaio]] | COMPLETED | [[https://translate-dev.freebsd.org/projects/documentation/|Documentation Project]] |
| Weblate Project for Website | [[/DaniloBaio]] | In Progress | [[https://translate-dev.freebsd.org/projects/website/|Website Project]] - In progress while we have open issues in the workflow. |
| Reopen Weblate | [[/DaniloBaio]] | COMPLETED | [[https://lists.freebsd.org/pipermail/freebsd-translators/2021-March/000364.html|Maillist announce]] |
| Weblate %%FreeBSD%% addon or Admin command | [[/DaniloBaio]] | In Progress | Necessary to adjust components properly. [[https://gist.github.com/dbaio/1de2235e35a2f5bb3363b54dbba4d36e|Weblate FreeBSD notes (gist)]] |
| Add more resources to current VM | [[/DaniloBaio]], [[/EdsonBrandi]] | COMPLETED | From 2vCpu/4Gb to 8vCpu/32Gb. Necessary because now there are 500+ Weblate components and it was very slow in the former VM. |
| po4a: Hugo/%%AsciiDoctor%% support (Major) | [[/DaniloBaio]] | COMPLETED | [[https://lists.po4a.org/archives/list/devel@lists.po4a.org/thread/6QK4LU3HO3GY4L6YRBHATK4WXYMORFFI/|po4a maillist]] - [[https://svnweb.freebsd.org/ports?view=revision&revision=566438|po4a v0.63]] |
| po4a: Asciidoc attributes issue (Major) | [[/DaniloBaio]] | COMPLETED | [[https://github.com/mquinson/po4a/pull/298|po4a PR298]] - [[https://svnweb.freebsd.org/ports?view=revision&revision=568387|po4a v0.63_1]] |
| Ignore chapters-order.adoc files | [[/DaniloBaio]] | COMPLETED | [[https://github.com/doc-br/freebsd-doc-weblate/blob/main/tools/update_translate_template.sh#L53-L57|update_translate_template.sh]] |
| Ignore toc*.adoc files | [[/DaniloBaio]] | COMPLETED | [[https://github.com/doc-br/freebsd-doc-weblate/blob/main/tools/update_translate_template.sh#L32|update_translate_template.sh#L32]] |
| Translate .toml files |  |  | We can't translate them right now, migrate to .adoc is a way. |
| Language directories |  |  | Hugo don't follow the standard pt_BR, it uses pt-br. Handle it in the scripts. |
| New variables in the translations |  |  | Example of variables just in the translated documents, [[https://cgit.freebsd.org/doc/tree/documentation/content/pt-br/articles/explaining-bsd/_index.adoc#n23|pt-br articles/explaining-bsd]]. We need that in the original document, otherwise the workflow with po4a won't work properly. |
| Use language variable in includes |  |  | Examples: [[https://cgit.freebsd.org/doc/tree/documentation/content/en/books/porters-handbook/plist/chapter.adoc#n26|books/porters-handbook]], [[https://cgit.freebsd.org/doc/tree/documentation/content/en/books/handbook/book.adoc#n34|books/handbook]]. Maybe there are other places that can use a language variable as well. |
| po4a: Lines with '+' sign are being translated wrong | [[/DaniloBaio]] | COMPLETED | [[https://cgit.freebsd.org/doc/commit/?id=f80bbbf56d7b9f87e93e25545073b98603da9b81|f80bb]] |
| po4a: Add YAML description string to .po files | [[/DaniloBaio]] | COMPLETED | [[https://cgit.freebsd.org/doc/commit/?id=f2d5f930d82a9f0ccb290dd020173302eceeea02|f2d5f]] |
| Re Enable Jenkins CI for translations | [[/DaniloBaio]] | COMPLETED | [[https://ci.fugbr.org/job/weblate-hugo/|Jenkins]] - [[https://ci.fugbr.org/files/|Jenkins Artifacts (Translations output)]] |
| Weblate Automatic Translation | [[/DaniloBaio]] | In Progress | Testing manual translations for pt_BR; next steps update wiki and send an announcement to the mailing list. [[https://github.com/WeblateOrg/weblate/pull/5764|weblate PR5764]] - [[https://gist.github.com/dbaio/1de2235e35a2f5bb3363b54dbba4d36e|Weblate FreeBSD notes (gist)]] |
| po4a: Fix YAML Front Matter / tags and trademarks | - | - | More details on [[Doc/Translation/Weblate/Documents]] |
| po4a: Do not work properly with tables and callouts | - | - | More details on [[Doc/Translation/Weblate/Documents]] |

===== FAQ (Frequently Asked Questions) =====

* Do we need to translate Copyright messages?

Every language team decides this for their own language, in pt_BR (Brazilian Portuguese) team, we decided not to translate those messages.

===== Credits =====

Document based on Fedora article about Zanata. [[https://fedoraproject.org/wiki/L10N/Translate_on_Zanata]]

----

{{tag>Services}}