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)
|
The [translator's guide](https://github.com/calamares/calamares/wiki/Translate-Guide)
|
||||||
on the wiki explains how to get involved there.
|
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
|
## Testing Calamares
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user