Transifex

  • Documentation
  • Projects & Content
  • Edit Source Strings Online

Edit Source Strings Online

Note

This feature is available on the Premium plan and up.

Editing source strings via API is available to all plans.

No need to rely on developers to fix minor typos and wording in source text by having them continuously upload source files. Such limitations cause delays in the localization process which means that tight deadlines might have failed to be met. Project maintainers can improve the wording in the source text by using the Transifex Web Editor. Customers who want to ensure proper grammar and alignment with other resources (marketing emails, Company’s Website) can now simply use the Translation editor in the same manner that they translate strings to other languages. After all the quality of the source text does matter.

  • Allowing users to modify the source text directly in Transifex. This only applies to resources that are key-based.

  • The Transifex platform now becomes the source of truth for source strings as well as Translations.

  • This functionality is only available to Project Maintainers and Organization Administrators.

  • This function is only supported for file formats with a key value structure. Source strings can be edited when uploaded using one of the following file formats:

    • Android XML
    • Apple Strings
    • Apple StringsDict
    • Chrome i18N
    • FreeDeskTop
    • PO (Gettext)
    • Java Properties
    • KeyValueJSON with ICU plurals
    • Structured JSON
    • Mozilla Properties
    • Wiki Markup
    • Windows .NET (Resx, Resw)
    • Windows JSON (resjson)
    • YAML
    • Fileless


  • This feature is not available for TX-Live.

  • Source strings uploaded using one of the following key-less file formats can't be changed in the editor; Word document (i18n type: DOCX), TXT (i18n type: TXT), HTML (i18n_type: HTML, XHTML), Subtitles (i18n type: SRT, SUB, SBV), XLIFF (i18n type: XLIFF), InDesign (i18n type: IDML), Markdown (i18n type: GITHUBMARKDOWN), TS (i18n type: QT) and Excel (i18n type: XLSX).

  • There is no option at the moment, to overwrite updated source strings in Transifex when uploading a resource file via Github/Bitbucket/Zendesk integration. If there are source strings updated in projects with such integrations, the resource file should be downloaded from Transifex and replace itself in the code repository. In this way, existing project integrations will not break and both Transifex and code repository will be synchronized.

Where To Modify A Source String.

There are at least 2 ways to Modify a Source String. They are:

  • From Project->Resources, click on the Edit Source Strings link as seen below:

    pic1_200702_103922.jpg#asset:7480

    Note: if this link does not appear then that means that the file format does not allow for source string edits.


  • From the translation editor select the source language from the drop-down list, or click the Edit Source link:

    pic2.jpg#asset:7382

    Note: if this link is greyed out then that means that the file format does not allow for source string edits.

Editing Source Strings While Viewing All Resources

Editing source strings option is available while viewing all resources in the editor, as long as the resources of a project are all supported for source editing:

all_resources_edit.png#asset:9134


When there is at least 1 resource that is not supported for source editing, then this option is disabled:

all_resources_edit_not_available.png#asset:9135


  • The user changes a source text and saves the new version. If the source string has already been translated in at least one target language, the user can either choose to keep these translations by clicking on the “Save & Keep Translations” button, or discard all previous translations by clicking on the “Save changes” button.

    edit_source_keep_translations.png#asset:8041


    Something important to note here is that, when the user selects to keep the translation, his/her name is set as the translator/reviewer (depending on the string status before the edit). Does this mean that the work that the translator did gets lost? Certainly not! Everything is saved in TM and available in the Editor as suggestion or historical data.

  • Each update from the original source text is logged: the user can see the different versions in the history tab. If the source string is not updated, the history tab will be empty.

    pic3.jpg#asset:7383

  • If TM Auto fill-ups are enabled and the updated source text a. is not translated and b. matches an existing source text in Translation Memory or the Translation Memory group, then the translation will be filled in automatically.

What Happens If A Source String Is Removed

If the user changes the source text by deleting all text, then the Save button is disabled.

Filters in Edit Source View

  • Updated source strings within the editor
  • While the user edits the source language, the filter "edited_source_string:yes" or "edited_source_string:no" will be available. 

  • If the user selects "edited_source_string:yes", then any string of a specific resource that has been edited, will show up in the results

  • If the user selects "edited_source_string:no", then any string of a specific resource that hasn't been edited before, will show up in the results

  • The filter 'source updated before/after' should work based on the fact that an updated string was edited.

  • Other available filters

filters_edit_source_view.png#asset:9737

Similar filters to the ones that are available in target languages are also available while viewing the Edit Source view. That way, you can easily find strings with specific text, status, tag, modification date, strings with issues or assigned screenshots, etc. What's worth highlighting is that you can also filter by origin using one of the following options:

origin_edit_source_view.png#asset:9738

Updating strings' metadata

When switching to the edit source view, you have several bulk actions available that allow you to modify strings' metadata.

Screenshot-2022-03-10-at-3.10.23-PM.png#asset:10093

You can update character limits, string instructions, or tags applying the same change to multiple stings at once.

  • From the UI: Update the resource using the instructions indicated here. Note that an option appears to replace edited strings. Checking this option overwrites updated strings modified in the editor.

    pic5.jpg#asset:7390


    Please note that, if the uploaded resource does not contain source strings that exist in Transifex, these will be deleted in Transifex, regardless if the option 'Replace edited strings' was checked or not.

  • From the API using the resource_strings_async_uploads endpoint. In order to replace edited strings via API, set "replace_edited_strings" to true

Updating Resource In User's Code Repository

There are two methods of updating the original source file located in your repository with updated strings (Source strings that have been modified):

  • Through the UI. Go to Resources. Then select your resource. Click on the source language in order to get the popup that appears below:

    pic-4.jpg#asset:7386

    Select the download resource link.

  • Using the API developers will periodically update their local source files with what's in Transifex.

CONTINUE READING