To initialize a project, use the
tx init command.
This is very similar to the way most VCS systems handle initialization. The command will create a new project in the current directory. This way you will be able to manage all translation files that exist under the project's root directory.
Here's a sample run:
$ tx init Creating .tx folder... Transifex instance [https://www.transifex.com]: Creating skeleton... Creating config file... No configuration file found. No entry found for host https://www.transifex.com. Creating... Please enter your transifex username: user Password: <...> Updating /home/username/.transifexrc file... Done.
It is safer to use encrypted HTTP (HTTPS) instead of plain HTTP in order to avoid having your user credentials crossing the wire out in the open. If you are using the client against the Transifex.com servers, the client will ask for your permission to switch all URLs to HTTPS.
Where to run init from
You may run this command from anywhere on your filesystem. It will create a small file which stores the mapping between your local files and Transifex resources.
If you have a software project in VCS and would like to commit this config file, in order to make it available to anyone who clones your repository, run the command from the root directory of your repo.
You might be managing multiple projects and would like a single configuration file. This is common with translators who use the client to manage their contributions across projects. In this case, you may run this command from a top-level directory.
If you want to automate the project initialization, the init command offers some options to set the default host, username and password so that you can use it with non-interactive scripts. For more information, check the help page of the command ('tx help init').