From Mageia wiki
Jump to: navigation, search

Transifex Synchronization Guide for l10n Team

Installation of Transifex Client Utility

To install Transifex Client use the corresponding page of your package manager (Install and Remove Software in Mageia Control Center). It is enough to install the transifex-client package and its dependencies.

Initial Setup

To use Mageia Transifex effectively, you have to add your credentials into transifex configuration file (the default location is ~/.transifexrc). You can either create such file using your favorite text editor (just add the following lines and save it as ~/.transifexrc):

[https://www.transifex.com]
hostname = https://www.transifex.com
password = <your_password>
token = 
username = <your_username>

[http://www.transifex.net]
hostname = https://www.transifex.com
password = <your_password>
token = 
username = <your_username>

(where <your_password> and <your_username> are respectively your password and your username) or you can use inbuilt configurator:

Konsole.png
[user@computer ~]$ tx init

Creating .tx folder... Transifex instance [https://www.transifex.com]: <Press Enter>

Creating skeleton...

Creating config file...

No configuration file found.

No entry found for host https://www.transifex.com. Creating...

Please enter your transifex username: <Enter your username>

Password: <Enter your password>

Updating /home/username/.transifexrc file...

Done.

[user@computer ~]$ _


The configurator can be run from any folder in your system.

Pushing Your Translation from Git Clone to Transifex

Open the folder with translations (usually /po) in your git clone (please refer to this page for the instructions on how to use git).

Enter the following command:

Konsole.png
[user@computer ~]$ tx push -t -l <your_locale>
[user@computer ~]$ _


Example:

Konsole.png
[user@computer ~]$ tx push -t -l uk
[user@computer ~]$ _


Use --force switch to force the replacement of the new Transifex translations. Example:

Konsole.png
[user@computer ~]$ tx push -t -l uk --force
[user@computer ~]$ _


Pulling Your Translation from Transifex to Git Clone

Open the folder with translations (usually /po) in your git clone (please refer to this page for the instructions on how to use git).

Enter the following command:

Konsole.png
[user@computer ~]$ tx pull -l <your_locale>
[user@computer ~]$ _


Example:

Konsole.png
[user@computer ~]$ tx pull -l uk
[user@computer ~]$ _