Set up localization using Weblate

[probonopd]

• Do we need a separate ts file, and hence a separate Weblate subproject for each of the utilities?
• How is Hosted Weblate supposed to get its permissions to push something into a GitHub Repository? Doesn't one need to enter a GitHub Token somewhere into the Weblate GUI? (Where is this documented?) --> Need to add the user weblate in https://github.com/helloSystem/Utilities/settings/access and give it Write rights
• Alternatively, how exactly does one need to set up hosted Weblate so that it creates (and appends to existing) GitHub Pull Requests instead of trying to push?

Pending on

• Approval from Weblate as a free hosted open source project
• Pushing changes from Weblate WeblateOrg/weblate#3533 (comment)

[probonopd]

Running pylupdate5 . -ts i18n/en.ts creates a file that Weblate can use to translate strings.

Questions:

• https://doc.bccnsoft.com/docs/PyQt5/i18n.html talks about pylupdate5 - do we need to use that one instead (from FreeBSD package py37-qt5-xml)? It doesn't seem to scan the whole directory tree at once but seems to require a .pro file which makes everything even more complex than needed?
• How do we get the translations split up so that we can put only the corresponding translations into each .app bundle for each application? (If we go with one ts file and hence one Weblate subproject per application, then maybe we don't even need to do this work...)
• Do we use raw .ts files in the .app bundles (which makes it easier to work on the translations while using the application) or do we need to compile them down to binary .qm files?
• Can we set up an automated process (e.g., GitHub Action) that handles extracting the translations from the source code files, and putting the translated strings into the application bundles, automatically?

[rbircher]

* Do we need a separate ts file, and hence a separate Weblate subproject for each of the utilities?

* How is Hosted Weblate supposed to get its permissions to push something into a GitHub Repository? Doesn't one need to enter a GitHub Token somewhere into the Weblate GUI? (Where is this documented?)

* Alternatively, how exactly does one need to set up hosted Weblate so that it creates (and appends to existing) GitHub Pull Requests instead of trying to push?

Pending on

* Approval from Weblate as a free hosted open source project

* [WeblateOrg/weblate#3533 (comment)](https://github.com/WeblateOrg/weblate/issues/3533#issuecomment-778759649)

Have a look at https://docs.weblate.org/en/latest/vcs.html You have to add the weblate User to the Git repo. So you can grant weblate access. For Upload it looks like a SSH Key is required.

[probonopd]

Addded the user weblate as a collaborator with read access on GitHub. In the hope that this will allow it to make pull requests.

[probonopd]

It is still not making pull requests.
What exactly do I need to configure in https://hosted.weblate.org/settings/hellosystem/utilities/#vcs so that it makes pull requests?

[probonopd]

Now setting git@github.com:helloSystem/Utilities.git as the Push URL in Weblate and giving the Weblate user Write rights in https://github.com/helloSystem/Utilities/settings/access...

This seems to have done the trick, no SSH keys neded.

But I would prefer the bot not to push but use Pull Requests...

[rbircher]

Yea absolutly. I don't know if it's even a good idea, to have this fully automated. Do we have controll who has access to the weblate instance?

[probonopd]

I think that only the Weblate admin for the project (that would be me) can trigger a push. In any case, the good thing about GitHub pushes is that they can be reverted if something goes wrong.

[rbircher]

Ok, this sounds good. Normally this translation scripts really works well. they don't destroy code. Well, I don't have experiance with this particular one, but with the one i worked, it worked really well.

[probonopd]

I am still looking for the leanest way to translate PyQt5 applications, ideally without the need to compile anything. After all, I chose PyQt5 specifically because it doesn’t need to be compiled…

Am I missing something?

https://forum.learnpyqt.com/t/impossible-translations/298/9

Not so easy:
https://simpleit.rocks/python/how-to-translate-a-python-project-with-gettext-the-easy-way/

Those extra steps for compiling are really bothering me.
After all, git is not great in storing compiled blobs, and we don't want to need a compile pipeline for PyQt stuff (or else we could have gone with a compiled language right from the start)

[probonopd]

Possibly we need to define a custom _ function that uses something like https://github.com/alexshpilkin/po/blob/master/po.py to extract the translation directly from a po file?

We can't be the first ones to run into this...?

[probonopd]

I have a proof-of-concept working for a system that uses raw Qt .ts files to translate the UI without the need for compilation:

This requires the Python module translate-toolkit to be installed with sudo python3 -m pip install translate-toolkit as it apparently is not available in FreeBSD packages.

The proof-of-concept currently uses .ts files from outside of the appliction bundle because we have all translations for all applications in entire repository in the same set of .ts files.
We probably need to split this up and have one .ts file for each application.

Is this possible to set up easily in Hosted Weblate without having to create one Weblate project per application in this repository?