Docs: add a note about updating / uploading translations
This commit is contained in:
parent
0fa28b88ae
commit
2042b338a7
@ -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
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user