## page was renamed from DocTranslationOnWeblate = 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. ||<#66CCFF> '''Item''' ||<#66CCFF> '''Responsible''' ||<#66CCFF> '''Status''' ||<#66CCFF> '''Note''' || || Weblate project for Documentation || [[DaniloBaio]] ||<#90FF90> COMPLETED || [[https://translate-dev.freebsd.org/projects/documentation/|Documentation Project]] || || Weblate Project for Website || [[DaniloBaio]] ||<#FFFF90> In Progress || [[https://translate-dev.freebsd.org/projects/website/|Website Project]] - In progress while we have open issues in the workflow. || || Reopen Weblate || [[DaniloBaio]] ||<#90FF90> COMPLETED || [[https://lists.freebsd.org/pipermail/freebsd-translators/2021-March/000364.html|Maillist announce]]|| || Weblate FreeBSD addon or Admin command || [[DaniloBaio]] ||<#FFFF90> 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]] ||<#90FF90> 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]] ||<#90FF90> 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]] ||<#90FF90> 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]] ||<#90FF90> 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]] ||<#90FF90> 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]] ||<#90FF90> COMPLETED || [[https://cgit.freebsd.org/doc/commit/?id=f80bbbf56d7b9f87e93e25545073b98603da9b81|f80bb]]|| || po4a: Add YAML description string to .po files || [[DaniloBaio]] ||<#90FF90> COMPLETED || [[https://cgit.freebsd.org/doc/commit/?id=f2d5f930d82a9f0ccb290dd020173302eceeea02|f2d5f]] || || Re Enable Jenkins CI for translations || [[DaniloBaio]] ||<#90FF90> COMPLETED || [[https://ci.fugbr.org/job/weblate-hugo/|Jenkins]] - [[https://ci.fugbr.org/files/|Jenkins Artifacts (Translations output)]] || || Weblate Automatic Translation || [[DaniloBaio]] ||<#FFFF90> 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]] ---- CategoryServices