You were redirected here from DocTranslationOnWeblate.

Translate FreeBSD on Weblate

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 Documentation Project
Weblate Project for Website DaniloBaio In Progress Website Project - In progress while we have open issues in the workflow.
Reopen Weblate DaniloBaio COMPLETED Maillist announce
Weblate FreeBSD addon or Admin command DaniloBaio In Progress Necessary to adjust components properly. 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 po4a maillist - po4a v0.63
po4a: Asciidoc attributes issue (Major) DaniloBaio COMPLETED po4a PR298 - po4a v0.63_1
Ignore chapters-order.adoc files DaniloBaio COMPLETED update_translate_template.sh
Ignore toc*.adoc files DaniloBaio COMPLETED 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, 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: books/porters-handbook, 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 f80bb
po4a: Add YAML description string to .po files DaniloBaio COMPLETED f2d5f
Re Enable Jenkins CI for translations DaniloBaio COMPLETED Jenkins - 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. weblate PR5764 - Weblate FreeBSD notes (gist)
po4a: Fix YAML Front Matter / tags and trademarks - - More details on Documents
po4a: Do not work properly with tables and callouts - - More details on Documents

* 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.

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


  • doc/translation/weblate.txt
  • Last modified: 2026/10/12 10:55
  • (external edit)