Table of Contents


Besides Translation Memory and Glossary, there are a few other tools – and things you should pay attention to too – which can be helpful as you translate.

History

The History tab in the editor contains information about how the selected string was translated in the past, including all the different translation versions submitted already and the different modifications that were done to the source string.

source_and_translation_edits.png#asset:9053

The history entries that refer to source text modifications are highlighted in grey.

Also, if you have the editor preference "Show difference with previous" setting enabled, then the difference between versions will be displayed by default:

In addition to this, you can also identify how the different source and translation versions were submitted to Transifex (e.g. via TM, via file upload, via Editor, etc.).

Tip: You can quickly access the History tab using the Ctrl+3 keyboard shortcut.


Glossary

The Glossary tab shows information about any glossary terms found in the string you have selected. Switch to that tab using the Ctrl+4 keyboard shortcut. See Using the Glossary for more.


Comments and Issues

If you have a question about the meaning of a string or see an error, you can leave a comment and/or open an issue.

Tip

  • Only users mentioned in the comment receive a notification about it.

  • Comments found under the comments tab in the editor remain available even after removing the target language from your project’s languages list

Comments

You can submit your comments, discuss the translation with other collaborators, or ask questions related to the source string.

Adding a comment

To add a comment:

  1. With a string selected, click the Comments tab or use the Ctrl+5 keyboard shortcut, then hit the Add comment button.

    add-comment.png#asset:5920

  2. Enter your message into the comment box and hit Add comment.

Replying To Comments

To reply to a comment, select "reply" to the sender or "reply all" to reply to everyone who submitted at least one comment for the specific string.

reply_all.png#asset:6164

Viewing strings with comments

There are several ways to find strings with comments in the Editor:

  • To find all the strings that have at least one comment, use the Comment filter (More > Comment) followed by *.

filter_all-comments.png#asset:5921
  • To find a specific comment, use the Comment filter followed by a keyword or phrase in the comment. For example, "Comment: context".

Issues

The Issues field can be used for providing feedback to translators or for translators to ask clarification questions about the strings they're translating. Opening and closing issues are an excellent way to track which questions have been addressed and implemented and which ones haven’t.

Tip

  • Maintainers are automatically getting notified - no need to be mentioned in the issue.

  • Users mentioned in the issue are also getting notified.

  1. Adding an Issue

    With a string selected, click the Comments tab or use Ctrl+5 keyboard shortcut, then hit the Add Issue button.

    add-issue.png#asset:5922

  2. Choose a priority and enter your message in the text box.

  3. Hit Add Issue to add the comment as an issue.

    Project maintainers will immediately receive in-app and email notifications when an issue is created.

The Categories field is also supported as can be seen below.

comments2.jpg#asset:6277

If you want to add the Categories field, please go to your Organization Settings page and Editor Settings -> Manage Categories. The ability to add categories will appear as seen below:

managecategories.jpg#asset:6278

To remove a category, click on the trash can icon as seen below:

delete-categories.jpg#asset:6280

To edit a category, just click on the pencil icon. Please note that a maximum of 20 categories can be added to your organization.

Adding Administrators

Only Organization Administrators can add categories to issues.

Viewing strings with issues

Comments and issues can be viewed by any collaborator of the translation team: if one translator asks a question about a string, all other translators/reviewers will also see the question and answers and won’t need to ask the same question again.

Open issues can be accessed directly via the link that is available on the project's overview page:

open_issues_link.png#asset:4016

Issues can also be filtered in the Editor: Label > Issue > Open/Resolved/None.

Filtering-issue.png#asset:5028

@Mentioning Recipients

If you want to leave a comment for a specific user, you can @mention them. Simply type @ followed by their username.

editor-comment-mention.png#asset:551

The recipient will receive in-app and email notifications and can go to the mentioned string(s) right from the email.

You can tag project maintainers, language coordinators, reviewers, and translators that belong to the project's team.

Resolving Issues

Once the question that was added as an issue has been answered by you or your teammate, and a translator or reviewer updates their translation according to the information received, the Issue needs to be marked as Resolved. This way, it will not appear as an open issue anymore. You can reopen the issue at any time.

issues_resolve.png#asset:5931

Who can mark the opened issues as resolved?


String Instruction and Developer Notes

Sometimes a developer might include notes about how a string is used within an app, or there are translation instructions for that string. These notes appear between the source string and the translation box.

Developer Notes

Developer Notes are imported within the resource file.

Screen-Shot-2018-05-17-at-10.33.30-AM.png#asset:4882

String Instructions

String Instructions can be added by clicking on "Edit Context" button in the Context tab.

Screen-Shot-2018-05-17-at-10.39.25-AM.png#asset:4883

If you want to add the same instructions to more than one string at once, then you can do that using the bulk editor actions as described below:

  • select the strings you would like to apply the same instructions to

  • Provide the text in the field shown below and click 'Apply'

Screenshot-2021-09-27-135313.png#asset:9432

This text will appear under the Source string throughout the translation process:

Screen-Shot-2018-05-17-at-10.34.12-AM.png#asset:4881

If you have String Instruction and Developer Notes, both will appear between the source string and the translation box:

Screen-Shot-2018-05-17-at-10.17.46-AM.png#asset:4884

Tags

Tags let you group a set of strings within a resource in any way you like. For example, you can use tags to specify where certain strings came from, or prioritize strings for translation using a tag called "Urgent."

Tags work on a string level, and when you add a tag, it is applied to all languages, even if you have selected a specific language in the Editor.


To tag strings, select one or more strings using the checkbox to the right of each string. Then, type in a tag in the Edit tags section, and hit Add.

editor-tags.png#asset:3823

When adding a tag to multiple strings, when you start typing, you will see a dropdown with suggestions of the existing tags in the current project.

new-tag1.png#asset:5374

Another way to add tags to your strings is via the Edit context button that is available under the Context tab in the editor.

add_tags_via_context.png#asset:4869

Similarly, if you start typing in the “Tags” area, a dropdown with suggestions of the existing tags in the current project will be available.

When using the tag filter in the Editor to search for a specific tag, a list of the existing tags will also be available:

new-tag2.png#asset:5376

Also, Transifex supports smart tags (locked, notranslate, locked_lang_code). These tags allow you to lock a string or prevent it from being translated into other languages.

More information about these tags can be found here.

Warning

Only maintainers, team managers, and administrator users have the privilege to assign tags to source strings.


Find and Replace

If you need to modify the translation of a word or a phrase en masse, you can use the find and replace functionality in the Editor. You can search for the entire word or parts of the words (or a character, for the non-space languages).

  • First, select the strings containing the word or phrase you want to update. You can easily use the filter "translation_text" to find these strings in Transifex Web Editor. Or you can select all strings in this project if it's a global change.

  • Then in the "Find and replace" section of the right panel, type in the word/part of the word you want to replace and, below that, the new word you want to use instead.

  • Finally, hit Find and Replace.

allow-partial-matching.png#asset:5429

If you're searching for a part of the word, click on Allow partial matching before hitting Find and Replace.


Bulk copy source strings into the translation string area

There might be cases where some strings shouldn't be translated, and the source version needs to be applied instead. Via Transifex Web Editor, you can select such strings and bulk copy their source text to the translation string area at once. To do that, you can follow the steps below:

#1: Enter the editor and select the strings for which the source version should be applied to

#2: In the mass action area, select how to handle the existing translated strings (if any), by either choosing 'Skip copying' (skip is by default selected) or 'Replace with source', and hit the button “Copy string”. If the choice is 'Skip copying', the operation will only add the source text to the translation box of untranslated strings. If the choice is 'Replace with source' , a verification popup will appear before this action is applied. If you choose to proceed, the operation will add the source text to the translation area for all the selected strings (translated or not), overwriting any existing translations.

copy_source_to_translation_mass_Action.png#asset:6437


Keyboard shortcuts

The Editor supports a number of keyboard shortcuts so you can quickly take action without using your mouse.

To see all the available shortcuts, enter the Editor, click on the Gear icon

settings_color.png#asset:1107

in the top right corner of the header, and hit Shortcuts.. in the top right corner of the header, and hit Shortcuts.

keyboard_shortcuts.png#asset:8554


View source strings in a different language

If you're translating to two similar languages, such as French (France) and French (Canada), you can view the translations of one as the source strings when translating the other. If, for example, you translated your content from English to French (France), you'd be able to see your French (France) translations as the source strings when translating to French (Canada).

  1. From within the Editor, click the Gear icon in the top right.

    settings_color.png#asset:1107

  2. Select Show source string in X.

    view_source_strings_in_different_lang.png#asset:6116

  3. In the popup, select the translation language that you want to see as source strings.

    editor-intermediate-language.png#asset:5

  4. Click Set language.


Tools in the translation area

Once you select a string from the string list to translate it, you can use some tools and functionality in the translation area.

translation_area.png#asset:4658


Tools in the source string area

The area where the source string is displayed has some functionality you can access using your mouse. Clicking on an active element in the source string will copy a part of that active element to the translation string area.

Control characters

Control characters are special characters that, when they are added to a text they don't have a visual symbol displayed by default (like when writing the character a, the symbol 'a' is added in the text). Those control characters are:

  • New line

  • Carriage return

  • Tab

  • Formfeed

  • Paragraph break

  • Line break

When one of these characters is present in the source string, there is a visual representation so that you know what control character is there. You also have the option to click on it and copy it to your translation.

Variables and HTML tags

In order to protect variables and HTML tags that exist in the source string, Transifex replaces them with special placeholders.

variables.png#asset:4660

When you click on those placeholders in the source string area, they are copied in the translation string area. Alternatively, use the keyboard shortcut Alt+number to copy an HTML placeholder or Ctrl+Alt+number to copy a variable placeholder. See Translating HTML Content for more details on what you can do with placeholders.

Glossary terms

When Transifex identifies that a word in the source string is also in the glossary, an underline is added to that word. When you hover on that word in the source string area, you will see a tooltip with the translation of that term in the target language you have selected. Clicking on that term in the source string area will copy its translation to the translation string area.

Editor-glossary-term.png#asset:3778

See Using the Glossary for more details on how to use the glossary in the Editor.

Tools in the translation string area

Shortcut buttons

Those are the buttons right above the translation. These include:

  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 character

    special-characters-icon.png#asset:3748

    - Insert special characters into the translation box (see below for details).

Special characters dropdown

This dropdown holds some common special characters so you can easily add them while translating.

Editor-special-characters.png#asset:3779

First, place your cursor where you want to add the special character to add a special character. Then:

  1. Click the Special characters button

    special-characters-icon.png#asset:3748

  2. In the dropdown, click on the special character you want to add.

Tip

Special characters RLM and LRM are used to change the way adjacent characters are grouped with respect to text direction. Check out Right to left mark in Wikipedia for more information. NBSP adds a non-breaking space (Unicode U+00A0) to the translation.


Character limits

Depending on what you are translating, you may need to keep a translation within a specific character limit not to break the user interface (for instance, in menus, buttons, and mobile apps where space is constrained).


In Transifex, you can set up character limits to ensure the translation meets this requirement.

  1. Click on the string and go to its Context tab in the editor

  2. Click on the "Edit Context" button

  3. Enter the desired limit into the corresponding field.

character_limit_set_string_level.png#asset:9408

If you want to add the same character limit to more than one string in the editor, then you can do that through bulk editor actions following the steps below:

- select the strings you want to apply the same character limit to

- provide the limit in the field shown below and click 'Apply'

Screenshot-2021-09-27-134703.png#asset:9433

Once the character limit is set, translators will see two numbers in the bottom left of the translation box: a character limit (10 on the screenshot) and a translation character counter (6 on the screenshot).

character-limit1.png#asset:5377

If the translation text exceeds the set character limit, the translation character counter area on the right side will be highlighted:

character-limit2.png#asset:5378

Tip

If a string has a character limit and contains placeholders, then those placeholders are not contributing any characters for that character limit.


Character counter

The character counter provides information about the length of the source and translation text. To turn it on, go to the Editor Preferences and toggle “Show character counter”:

character_count_preference.png#asset:6118

  • If the character limit is not set, the character counter will be displayed as follows: source character counter on the left and translation character counter on the right.

character-counter2.png#asset:5380

character-counter3.png#asset:5381
  • If the character limit is set up, the character counter will be displayed as follows: character limit on the left and translation character counter on the right.

character-limit1.png#asset:5377


Translate using the raw mode

The default mode of Transifex Editor is the rich mode. In this mode it is easier to work when you are a translator and want to focus on translation and context, hiding and protecting all technical details that usually don't offer any value to the localization process.

Still, there are cases where you want full access to the exact source string, as this is stored in the database. To view the source strings without the placeholders for variables and HTML tags, you must use the Editor settings on the top right corner of the editor page.

Editor-in-raw-mode.png#asset:3780

Raw mode of the editor is ideal for:

  • Editing all HTML attributes and values

  • Editing and adding all characters that you want without the editor applying special compatibility escaping for your file format (JSON, android XML)

In raw mode of the editor we maintain some functionality to help you while translating but this is optional:

  • Variables are displayed in italics and you still can click on them in the source string area

  • Control and Special characters are also visible and clickable

  • Glossary terms can also be used

For usage details on the above, please see tools in the translation area.


Translate using the Transifex dark editor mode

To enable the dark mode in Transifex Web Editor, you just need to enable the corresponding setting under the preferences option:

dark_editor_preferences.png#asset:6119

After that, the editor will immediately be displayed in dark mode as follows:


dark_editor_mode.png#asset:6120

back to top


Continue Reading

Introduction

Working with Projects

Resources and Content

TX Editors and Translations

Transifex Native

Transifex Live

Languages and Locals

Did this answer your question?