1. Set up your projects
First things first: you need to create an organization within Transifex - this is where all your translation management activity will happen. Transifex is set up as a directory of projects. Projects contain resources.
Read more about creating an organization and organization structure here.
Next, create your first project by following these steps.
File-based and Live projects
File-based project works with files (e.g. .po, .yml, .strings) - where you upload the files to Transifex, get them translated within Transifex, then pull them back to your development environment.
Live project is a java-script-based approach, great for translating not too dynamic websites where Transifex identifies the strings to translate on the front end and serves the translations back to your website.
Source and Target Languages
When choosing a source language, make sure that you stay consistent across all your projects: e.g. if you choose generic “en” in your first project, choose it in all subsequent projects that you or your team members create later on. This will help such great features as Translation Memory and Glossary work fine and be shared across all your projects.
When choosing target languages, our recommendation would be to choose a locale-specific target language (e.g. es_ES vs es). Unless you have a particular reason to use generic language codes, it’s better, for the sake of clarity, to specify the locales, especially for the dialects such as French (France and Canada), Spanish (Spain and Latin America), Portuguese (Portugal and Brazil), and Chinese (Simplified and Traditional).
With target languages, similarly to source languages, make sure to stay consistent when adding languages across your projects in Transifex: if you chose “es” for Spanish-Spain, stick to it across all your projects.
There are a few ways to move your content to Transifex for translation:
Uploading the files into projects manually (read more here)
API (read more here)
CLI Client (read more here)
Integrations with the tools you use (read more here)
Read more about the supported file formats here.
If you get file upload errors for a supported format, you can send firstname.lastname@example.org a sample of the file and we can help assess why the upload failed and provide further recommendations.
A few things to keep in mind: