Transifex

  • Documentation
  • Translating
  • Translating with the Web Editor

Translating with the Web Editor

Transifex provides translators with a space to work on content without needing to worry about handling files. The Editor is accessible from any web browser, and multiple people can translate the same file in parallel. In this article you will find:

Getting to the Editor

Here's how you can get to the Editor:

  • From the project navigation in the Dashboard, click on the project you want to translate.

  • Click the Translate button on the right side of the header.

    project-dashboard.png#asset:486

  • In the language dropdown, choose which language you want to translate content to. Depending on your role, you might only see the languages you've been given permission to work on.

    editor_filters_1.png#asset:4625


  • Click on the resource you'd like to translate. You only need to do this if there is more than one resource in the project.

    editor_filters_resources.png#asset:4626


Note

If you're translating a Live project instead of a file-based project, the button in the Dashboard header will say "Live" instead of "Translate." Clicking it will take you to the Transifex Live in-context editor. You can read more about translating with Transifex Live here.

Searching and filtering for strings

After you've selected a resource to translate, you'll see on the left side a complete list of translatable phrases (strings) in the resource. Above the list, there is a set of tabs – All, Untranslated, and Unreviewed – along with a search box. These are helpful when you want to find a specific string or subset of strings to work on. For example, if you want to just see the untranslated strings, click the Untranslated tab.

For more filtering options, you can use:

  • Click in the search box search.png#asset:1110 above the strings list, or use Alt+s shortcut to see the list of the available filters. Find the one you want by either scrolling through the filters' list or typing the filter's name in the search input.

    editor_filters_search.png#asset:4628


  • Click on a filter to use it. Depending on what filter you select, you may need to make a selection or enter a search term. You can combine multiple filters together to narrow your strings list down even more. For example, you can find all unreviewed strings tagged with "account" See all available filters.

    editor_filters_search1.png#asset:4630


Grouped filters help you to get an overview of the filters that Transifex supports.

Groups can be hidden if you do not want to use them for a while. In order to hide or reveal these groups click on the "Filters" option that is displayed on the left side of the magnifier icon.

hide_reveal_group.png#asset:4640

 

  • Click on a grouped filter and select the one you want to manipulate.

    grouped_filters_1.png#asset:4641


  • Once the desired filter is selected, depending on its type, you will need to either make a selection or provide a search term.

    search_input.png#asset:4642

    The search box will properly be updated allowing you to see the filters you have already applied

    filters_search_results.png#asset:4643


Translating strings

After finding the strings you want to work on, it's finally time to translate!

Here's how to translate strings in Transifex:

  • From the strings list on the left, click on the string you want to translate. Your selected string will appear on the right hand side in the source string area.

  • Type your translation into the translation area below the source string area.

    editor_filters_untranslated.png#asset:4631


  • Hit Save or you can hit Save all after you translate several strings.

The Editor has a set of tools and shortcuts that can help you when translating a string.

Appendix

In this section you will find all the details of Web Editor actions and functionality. The available actions are grouped based on the area that you can access them.

Editor Navigation area

The main navigation of the editor is used to change what the whole Editor is displaying.

Resource selection list

The selected resource is displayed on the far left side of the navigation area. Clicking on it will display a list of all the available resources for the project you are translating.

editor_filters_resources1.png#asset:4632


For each resource in the list you can see:

  • On the left side the resource priority icon, ranging from Urgent to Normal priorities.
  • Information about the number of the untranslated and unreviewed strings in that resource.
  • A bar indicating the localization progress for that resource.

Clicking on a resource will load all the strings that this resource contains in the Web Editor so that you can translate them.

At the bottom of the list is another option called "All resources" which will load all the strings of the project regardless of the resource those strings come from.

Source and target language

Right next to the selected resource in the navigation area you can see information about the source language of the project and a dropdown to select the target language you want to translate to. The languages that populate this dropdown are all the languages that the selected project is translated too.

Overview button

Clicking the Overview toggle button you can see all the strings and their translations for the selected resource. This mode can be used for quick previewing default strings and the translations.

editor_overview.png#asset:4633


Concordance button - TM search

This is a switch to enable and use Concordance search on the Translation Memory of the project. See Using Translation Memory and Concordance Search for more.

editor-gear-view.png#asset:4734

Clicking the gear icon you will see all the available options to change your editor settings. All the available options are:

  1. Link to your editor preferences
  2. Option to display strings in another language, than the source to help you translating similar languages
  3. Link to display all the keyboard shortcuts you can use in the Web Editor

editor-preferences.png#asset:4735

Clicking Editor preferences you have options for:

  • Raw mode of the Web Editor, affecting the whole editor
  • Use placeholders shortcuts, when translating
  • Display spaces, in both source and translation string's area when translating
  • If your project has video subtitles and there is a video available, there is an additional option to enable the video preview. See Translating Video Subtitles for more
  • Show translations in the string list
  • Show full strings in the string list

Any changes you do on editor preferences are applied instantly.

String list area

editor_strings_info.png#asset:4634


In this area you can see all the strings from the resource you have selected. Each string in the list shows some valuable information about the string:

  • The number on the far left of the string represents the order of that string in the resource, you can use this number to organize your work in batches.
  • Right next to that number is the localization status icon of that string for the selected target language. A grey dot is for an untranslated string, a green dot for a translated one and a check indicates a reviewed string.
  • Then the string in the source language is displayed.
  • If the string has a translation for the selected target language then it is displayed after the source language.
  • On the right side of the string there is a checkbox that is used when you want to perform actions on multiple strings.

Additional info:

  • If a string has tags or is mapped to a screenshot, then additional icons will be displayed next to the source strings. 

tag_screenshot.png#asset:4635

  • If a translation is saved but a warning message occurs, then you will see an exclamation mark in the place of the status icon.

warning_icon.png#asset:4636

  • If errors occur while trying to save a translation, then you will see an x icon in the place of the status icon.

error_icon.png#asset:4637


Available filters

There is a number of filters available in the Editor. Here's what each one means:

Group "Text"

Filters related to string text, containing:

  • Text – Search for source strings containing a specific word or phrase.
  • Translation text – Search for translation strings containing a specific word or phrase.

Group "Status"

Filters related to localization status of a string:

  • Translated – Search for strings based on whether it's translated or untranslated.
  • Reviewed – Search for strings based on whether it's reviewed or unreviewed.
  • Proofread – Search for strings based on whether it's proofread or not.

Group "Tag":

  • Tag – Search for strings with a specific tag assigned

Group "Users":

  • Translator – Search for strings that were translated by a specific collaborator. After selecting the "Translator" filter, a list of suggestions will be available. If the user you are looking for is not part of that list, then you can search by his/her username if you know it.
  • Reviewer - Search for strings that were reviewed by a specific collaborator. After selecting the "Reviewer" filter, a list of suggestions will be available. If the user you are looking for is not part of that list, then you can search by his/her username if you know it.

Group "Date"

Filters related to localization dates and string's history:

  • Translated before – Search for strings that were translated prior to a specific date.
  • Translated after – Search for strings that were translated after a specific date.
  • Source Updated Before – Search for strings that were updated before a specific date.
  • Source Updated After – Search for strings that were updated after a specific date.

Group "Label"

Filters that can be switched on or off, containing:

  • Issue – Search for strings based on whether it has an open issue or not.
  • Warning - Search for strings with or without warnings.
  • Pluralized – Search for strings based on whether it has a pluralized version or not.
  • Screenshot - Search for strings with or without screenshots.

Group "More"

All remaining filters that do not belong in any of the above groups:

  • Key – Search for text in a string's key
  • Occurrence - Search for strings by a specific occurrence
  • Origin – Search for strings based on the translation source, e.g. Translation Memory, Machine Translation, or a vendor you ordered from.
  • Comment – Search for strings containing a specific word or phrase in the comment.

Syntax help, using the search filters input

  1. Text, Translation text and Key filters offer additional options for searching by Whole-word search. This can be achieved by enclosing your terms in double quotes (for example, "Contact Transifex"). Doing whole-word search will match strings as defined within double quotes.
  2. When typing your filters using the generic filters input, you have to include each filter's value in single quotes as it is indicated in the suggestions list:

suggestions_list.png#asset:4736

Having single quotes as value delimiters, especially for text filters, means that you should escape single quotes when you want to use them as part of a value. e.g. searching for text "this isn't something to look for", you'll have to type it with single quote escaped like "this isn\'t something to look for". 

Below you can find some examples about how to search text that contains single quote characters and make sure that you will get the correct results:

  • Click on the search box, and type the text you want to search for without selecting the text filter:
example_1_single_quote.png#asset:4737

After hitting Enter, the expected results will be returned.

Use the grouped filter Text>Text and provide your input as follows:

example_2_single_quote.png#asset:4738

The result of the above 2 examples will look like this:

result_of_examples_1_2.png#asset:4739

As you can see when single quotes are part of your input then we automatically escape them on purpose since the whole input is already enclosed by default in single quote characters in order to allow you to search based on the whole text you provide. 

To filter for any string that has a comment, regardless of what the comment says, use the Comment filter and then type "*".

Manipulating filters

  • Disabling filters

In order to disable an already applied filter, you need to either remove it from the search box and then hit Enter:

remove_filter_search_box.png#asset:4644


or click on the corresponding grouped filter, find the one you want to remove and simply click on it as follows:

remove_filter_grouped_area.png#asset:4648


  • Editing filters

In order to edit the value of an already applied filter, you need to either edit it directly in the search box and then hit Enter or click on the corresponding grouped filter, find the one you want to edit and use the pencil icon so as to apply the changes.

edit_filters_grouped_area.png#asset:4646

Translation Area

This is the main area that you use to translate strings. This contains the source string area and translation string area.

Shortcut buttons

editor_actions_toolbar.png#asset:4639


Beneath the source string area is the actions toolbar, there are some helpful shortcut buttons:

  1. Copy source string copy-source.png#asset:1113 – Copy the source string into the translation box (you'll still need to hit Save). This is useful if you're translating between two similar languages, such as English (United States) and English (United Kingdom).
  2. Machine translate autotranslate.png#asset:1114 – Use machine translation to translate the string. You'll need to have Machine Translation set up first.
  3. Revert translation undo.png#asset:1115 – Reverts any changes that you have made to the translation. If the string was untranslated then it clears your translation, otherwise reverts to last saved translation.
  4. Add special characterspecial-characters-icon.png#asset:3748- Insert special characters into the translation string area.
In the actions toolbar you will also see the plural toggle buttons for strings that have plural forms.

Note

Source and target languages don't always share the same number of plural forms! So there will be cases where the plural toggle buttons will not match one to one

Warnings and error messages on translations

Transifex automatically checks every translation you save for certain errors. Those translation checks are set by administrators to ensure that the translations will maintain vital information and the format needed so that the application displays correctly the target language (like variables, code parts, numbers, character limit etc.). If you are an administrator, see Setting Translation Checks for more.

error_in_translation.png#asset:4638


If you get an error or warning message when you try to save a translation, please fix the issue specified in the message and save the translation again.

Handling HTML tags and variables

As you translate, you might come across strings containing blue or green oval-shaped placeholders. These are placeholders for HTML tags or variables. For more on how to handle these, please see Translating HTML Content.

Other Editor tools

The Editor has a number of other tools to help you as you translate. You can checkout Other Tools in the Editor for more details.