FAQ on migration to Transifex.com

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
(Make a "Where")
(Fix markup)
Line 24: Line 24:
 
All these instructions assume that you have already visited https://transifex.net and set up your project there.  If you haven't done so yet, you can [https://www.transifex.net/projects/add/ visit this link] to add your project to Transifex.  Note your project's ''slug'' on the site, which is usually its name rendered in all lowercase.  If you can't remember that setting, visit the project page and select ''Edit'' to look at the settings.
 
All these instructions assume that you have already visited https://transifex.net and set up your project there.  If you haven't done so yet, you can [https://www.transifex.net/projects/add/ visit this link] to add your project to Transifex.  Note your project's ''slug'' on the site, which is usually its name rendered in all lowercase.  If you can't remember that setting, visit the project page and select ''Edit'' to look at the settings.
  
{{admon/note | Conventions | The rest of the instructions will use the following conventions:
+
The rest of the instructions will use the following conventions:
* $PROJECT_SLUG = the slug for your project. If you can't remember it, visit the project page and select ''Edit'' to see the setting.
+
; $PROJECT_SLUG
* $RESOURCE_SLUG = the slug for a resource. If you can't remember it, visit the project page, select the resource, and then select ''Edit'' to see the setting.
+
: the slug for your project. If you can't remember it, visit the project page and select ''Edit'' to see the setting.
* $SOURCE_LANG = the source language for your project. Usually this is "en".
+
; $RESOURCE_SLUG
* $POTFILE = the POT file for a single-POT project, usually saved as po/<project_name>.pot
+
: the slug for a resource. If you can't remember it, visit the project page, select the resource, and then select ''Edit'' to see the setting.
}}
+
; $SOURCE_LANG
 +
: the source language for your project. Usually this is "en".
 +
; $POTFILE
 +
: the POT file for a single-POT project, usually saved as po/&lt;project_name&gt;.pot
  
==== My project has a po/ folder, and a single POT and multiple PO files ====
+
==== My project has a po/ folder, a single POT and multiple PO files ====
 +
{{admon/note | This is how many GNOME projects are set up.}}
  
 
In your checked-out project repository (e.g. a SVN checkout or git clone), run:
 
In your checked-out project repository (e.g. a SVN checkout or git clone), run:
Line 38: Line 42:
  
 
To declare your POT file and the source language (probably "en"), run this command:
 
To declare your POT file and the source language (probably "en"), run this command:
<pre>tx set --execute --auto-local -r $PROJECT_SLUG.$RESOURCE_SLUG -s $SOURCE_LANG -f 'po/$POTFILE' 'po/<lang>.po'</pre>
+
<pre>tx set --execute --auto-local -r $PROJECT_SLUG.$RESOURCE_SLUG -s $SOURCE_LANG -f $POTFILE 'po/<lang>.po'</pre>
  
 
To push existing translations in your repository to the Transifex server, run:
 
To push existing translations in your repository to the Transifex server, run:

Revision as of 19:48, 25 February 2011

Contents

When

Fedora translation projects were migrated to Transifex.net on Friday, February 18, 2011. Projects on Fedora Hosted will be given a chance to opt-out, and those who don't opt-out will be migrated over the next two weeks.

Why

Why now and not wait for the next version?

We are lacking resources to manage our current infrastructure, and the L10n group decided that the Fedora 15 translations are in danger. All related Fedora groups (L10n, Infrastructure, Packaging, Docs and Board) have concluded that there is little risk in the move.

Where

Where do I get the "tx" command-line utility?

The transifex client is currently available as the transifex-client package in Rawhide (pre-F16), and in the updates-testing repositories for Fedora 13, 14, and 15, and EPEL 5 and 6.

Where can I get more help on using the Transifex client?

Additional help for the Transifex client is available at transifex.net

How

How do I use "tx set" properly?

All these instructions assume that you have already visited https://transifex.net and set up your project there. If you haven't done so yet, you can visit this link to add your project to Transifex. Note your project's slug on the site, which is usually its name rendered in all lowercase. If you can't remember that setting, visit the project page and select Edit to look at the settings.

The rest of the instructions will use the following conventions:

$PROJECT_SLUG
the slug for your project. If you can't remember it, visit the project page and select Edit to see the setting.
$RESOURCE_SLUG
the slug for a resource. If you can't remember it, visit the project page, select the resource, and then select Edit to see the setting.
$SOURCE_LANG
the source language for your project. Usually this is "en".
$POTFILE
the POT file for a single-POT project, usually saved as po/<project_name>.pot

My project has a po/ folder, a single POT and multiple PO files

Note.png
This is how many GNOME projects are set up.

In your checked-out project repository (e.g. a SVN checkout or git clone), run:

tx init

This command creates a ~/.transifexrc file for your user account, and a .tx/config file in your project working tree.

To declare your POT file and the source language (probably "en"), run this command:

tx set --execute --auto-local -r $PROJECT_SLUG.$RESOURCE_SLUG -s $SOURCE_LANG -f $POTFILE 'po/<lang>.po'

To push existing translations in your repository to the Transifex server, run:

tx push -t

My project uses multiple POTs

 ???

(Your own question here...)