Good news everyone! 
documentation is now integrated with our #Weblate for translations, thanks to #po4a. If you want to contribute, check out:
➡️ https://translate.yunohost.org/projects/yunohost-doc/
Don't hesitate to poke us if you need us to add additional language.
If you interested, we also have a new documentation page describing how translation works across the whole project:
#po4a was released today. It helps maintaining the translations of your documentation.
We have new format modules (org, vim-help and SimplePod -- future replacement of our aging pod parser), fixes & new features for the AsciiDoc, Markdown, TeX and Texinfo, some code modernization and many translations. Thanks to all.
This release is dedicated to Simone Weil, whose ideas and commitment remain inspirational. But please people, do not die for your ideas the way she did.
Status update of my public activity for the last month. With some FOSS activity (because I had some this month, on #po4a), teaching activities (C++, didactic), administrative duties, some research activities on #SimGrid, on the #SmolPhone and on other #LowTech and #FrugalComputing thingies.
http://people.irisa.fr/Martin.Quinson/blog/240131/Status_update:_January_2024/
I just released #po4a v0.69 https://github.com/mquinson/po4a/releases/tag/v0.69
po4a eases documentation translations and their maintenance. It extracts the translatable material from the original document, and places it into a PO file that is adapted to the translation process. Once this PO file is updated by the translator, po4a re-injects the translation into the structure of the original document to generate a translated document.
This version sanitizes the internal code around YAML and improves placeholders in XML.
The 2 next issues I'd like to solve in #po4a are https://github.com/mquinson/po4a/issues/272 which really improves the user experience, and https://github.com/mquinson/po4a/blob/master/lib/Locale/Po4a/TransTractor.pm#L1354 that would allow the use of #po4a for new formats (such as debconf in Debian, or desktop files).
If someone wants to rewrite it in another prog language, why not. The test suite shall be useful for that. But I won't do it myself. Perl is oldish, but it still does the job for now.
Thanks for your support, @jibec ;)
@jibec Oui, le langage Perl vieilli mal, mais je pense que l'archi logicielle est assez propre. Disons que je vois pas plus simple, quoi.
Le changement qui m'a agacé était une simplification: avant, il y avait un parseur YAML pour les fichiers .yml et un autre parseur pour les entêtes YFM de l'asciidoc et markdown. Le 1er supportait le filtrage par chemin, et le second gérait mieux les valeurs num.
Fusionner les 2 m'a fait rager, mais c'est mieux ainsi. Ct la dernière verrue connue dans #po4a.
A new release of #po4a (with PRs from several ppl -- thanks to them) will be out this week-end, once the translators update their work.
https://github.com/mquinson/po4a/blob/master/NEWS
po4a is a tool to maintain the translation of documents that get regularly updated, such as FOSS documentation and websites.
https://po4a.org/
It was my thesis avoidance project 20 years ago. Someone maintained it 10 years, I took it back but a new volunter is needed: https://www.volunteeramnestyday.net
Please consider helping. Please boost
Ceci n'a peut-être l'air de rien, mais ça m'a pris des heures pour trouver une solution 🙄
La page d'accueil de la #documentation de #Fedora contient plus de #HTML que de #asciidoc. Alors on dit à #po4a que c'est de l'xml:
https://pagure.io/fedora-docs-l10n/docs/c/6d985276e9f64579053264f9e48fadb3a1d993d2?branch=master
Puis dans #Weblate, on verrouille la partie asciidoc pour éviter les erreurs lors de la #traduction ❤️
YunoHost 
Martin Quinson ⏚
Nicolas Pettiaux
Jean-Baptiste