Docs: add a note about updating / uploading translations

This commit is contained in:
Adriaan de Groot 2024-08-13 15:49:05 +02:00
parent 0fa28b88ae
commit 2042b338a7

View File

@ -218,6 +218,41 @@ Calamares translations are done on Transifex.
The [translator's guide](https://github.com/calamares/calamares/wiki/Translate-Guide)
on the wiki explains how to get involved there.
### Using Transifex
> This section is copied from the wiki. Please read the wiki for more details.
Calamares uses [Transifex](https://www.transifex.com/) as its translation
inrfastructure.
The [project overview](https://www.transifex.com/calamares/calamares/) for Calamares
shows which languages exist and how translated they are.
Translations are (semi-)regularly updated from the *calamares* (development)
branch of Calamares and sent to Transifex; updated translations are
imported into the same *calamares* branch.
This means that stable releases don't get translation updates --
I have not thought of a good way to do that with one Calamares
project in Transifex.
Internally, the program uses **both** Qt translations and GNU
gettext. This is invisible for the translator, but it does mean
that the same string can show up in two different Calamares string collections.
### Using Pull Requests
> Please avoid using PRs to update translations if you can.
> They **can** be merged back to Transifex, but it's somewhat
> annoying to do so. You can merge your updated translations files
> (the `.ts` files) to Transifex as described in this section.
- Log in to Transifex
- Select the language for upload (e.g. Arabic)
- Click the resource to update (e.g. *Calamares* which is the one for the
bulk of the strings from the program itself, stored as
`lang/calamares_ar.ts` in the repository)
- Click *Upload file* and pick the right `.ts` file
- Click the *Translate* button to double-check the uploaded translations.
## Testing Calamares