Introduction to Projects and Resources
Transifex helps you manage translations of your apps, website, documents, and more. Each Transifex organization is organized around projects and resources. Before we dive into how you can create a project or add content for translation, let's walk through what resources and projects are.
Resources are content you're translating along with their corresponding translations. Let's say you're translating a file named file.po (the source file) from English into French and German. When you upload file.po to Transifex, Transifex will automatically create two new files for you – file_fr.po and file_de.po. These new translation files will hold your French and German translations, respectively. Together, the three files form a single resource in Transifex.
Once you understand what resources are, it's easy to understand Projects. Projects are simply a collection of resources. You can create as many projects as you need, and there's no limit to how many resources can be in a project.
Projects can be organized in any way you like. Think about the projects as directories and resources as files. Here are a few things to keep in mind:
- It's best to group related content into a single project. For example, one project for your iOS app, and another for your website. Each project has certain settings and configuration options (e.g. translation team, translation memory, workflow settings).
- Each project is translated to one or more languages (target languages). If you have content that needs to be translated to separate sets of languages, create separate projects for them. If you really want to have content in the same project which needs to be translated into different languages, you will need to tell your translators directly to remember not to translate those files into some of the project's languages.
- Each project is also assigned to a team of translators and reviewers. If you have two resources which you wish to be translated by two different teams, put them in separate projects.
- If you are using files, then one file is associated with one resource. In certain cases, you might have thousands of phrases in your database which can be grouped in different ways into resources. Here, it's really up to you: you can have one big resource or multiple smaller ones:
- One big resource will make it easier for translators to go over the phrases.
- Multiple smaller ones allow you to further group your phrases in some logical way and to have multiple same phrases which need to be translated in different ways, etc.
Here's an example structure which can help illustrate some of these ideas.
- Resource: FAQ
- Resource: About
- Resource: Introduction
Project: Android app
- Resource: UI labels specific to customer X
- Resource: Translations of city names showing in the app
- Resource: UI phrases
Project: User-generated content
- Resource: Customized menu label
- Resource: User Comments
- Resource: Product Reviews
In the above example, you could also argue that the resource type "UI labels specific to customer X" might be better grouped on a separate project, so that they're all together. It's really up to you. If you have just 1-2 customers, leave it under the project. If you have 100 customers, put it under a separate project. If the number of labels per customer is just a couple, instead of having 100 resources of 2 phrases, you might want to have just one resource with 200 phrases and use tags to distinguish each customer.