Although English is the official base language for all UBports projects we believe you have the right to use it in any language you want.
We are working hard to meet that goal, and you can help as well.
Tools for Translation¶
- For everyone: A web based translation tool called Weblate. This is the recommended way.
- For advanced users: Working directly on .po files with the editor of your choice, and a GitHub account. The .po files for each project are in their repository on our GitHub organization.
We also have a Translation Forum to discuss translating Ubuntu Touch and its core apps.
You can go to UBports Weblate, click on “Dashboard” button, go to a project, and start making anonymous suggestions without being registered. If you want to save your translations, you must be logged in.
For that, go to UBports Weblate and click on the “Register” button. Once in the “Registration” page, you’ll find two options:
- Register using a valid email address, a username, and your full name. You’ll need to resolve an easy control question too.
- Register using a third party registration. Currently the system supports accounts from openSUSE, GitHub, Fedora, and Ubuntu.
Once you’re logged in, the site is self-explanatory and you’ll find there all the options and customization you can do.
Now, get on with it. The first step is to search if your language already exists in the project of your choice.
If your language is not available for a specific project, you can add it yourself.
You decide how much time you can put into translation. From minutes to hours, everything counts.
.po file editor¶
As was said up above, you need a file editor of your choice and a GitHub account to translate .po files directly.
There are online gettext .po editors and those you can install in your computer.
You can choose whatever editor you want, but we prefer to work with free software only. There are too many plain text editors and tools to help you translate .po files to put down a list here.
If you want to work with .po files directly you know what you’re doing for sure.
Translation Team Communication¶
The straightforward and recommended way is to use the forum category that UBports provides for this task.
To use it you need to register, or login if you’re registered already.
The only requirement is to start your post putting down your language in brackets in the “Enter your topic title here” field. For example,
[Spanish] How to translate whatever?
Just for your information, some projects are using Telegram groups too, and some teams are still using the Ubuntu Launchpad framework.
In your interactions with your team you’ll find the best way to coordinate your translations.
All the translation projects, and all your contributions to this project, are under a Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license that you explicitly accept by contributing to the project.
Go to that link to learn what this exactly means.