š Note: This article only applies to file-based projects.
When translating an app or website, you'll likely add and change strings constantly, meaning the files with your source content will also change. Instead of uploading a new file and creating a new resource each time a file changes, you can update an existing resource. There are a few ways to update files in Transifex.
Manually updating source files
To manually update source files:
From the project navigation in the Dashboard, click on the project, which contains the resource you want to update.
Click the Resources link.
Click on the resource you want to update.
In the header, click Update source file.
Before uploading the new version of your source content, ensure that you select the appropriate options for the upload:
Replace edited strings: By checking this option, any strings you update that were previously modified in the editor will be overwritten. Read more about edited strings here.
Keep existing translations: Selecting this option allows you to retain translations when you update the source text of your strings.
There are several scenarios depending on the fileās contents and whether the options "Replace edited strings" and "Keep existing translations" have been selected. These scenarios are depicted in the below diagram.
š”Tip: The image may be too small when viewing the article. Please feel free to click it so it opens in its own tab and view it at full size.
Also, it's important to note that if the new source file version does not include any source strings, all currently hosted strings in Transifex will be deleted, regardless of whether the "Replace edited strings" option was checked.
Automatically updating source files
Manually updating source files isn't fun or scalable if you've got frequent updates. To avoid this, you can have Transifex automatically check for updates to your source file by simply providing Transifex with the file's public URL. The file can be hosted on any service, such as GitHub or Dropbox. For services like Filezilla, though downloading is blocked for a script, automatically updating source files via URL is not supported.
š Note: You can also use a file from a private repository in GitHub if the URL has the respective token that GitHub provides.
Transifex will check that URL for updates four times per day (every six hours). If the file changes, it will fetch the file and update the resource in Transifex.
Because the check happens four times a day, there may be a delay between when you update a file and when Transifex detects the changes. The updated resource will automatically be available to your translators and reviewers.
Here's how to set up automatic updates of source files:
Select a project from the project navigation in the Dashboard.
Click the Resources link.
Click on the three dots on the top right and then Auto-update resources from the drop-down menu.
In the popup, click on the resource you want to auto-update.
Add your file's URL and click Update URL. Transifex will check to make sure the file can be accessed.
š Note: The file updates could be delayed due to the number of file update tasks the system needs to process.
This means the system may need 15 minutes more to process all the pending tasks in the queue for all the resources that are expected to be updated simultaneously.
If you want to stop auto-updating a resource, simply remove the URL to the file. After doing so, you'll receive three warning emails letting you know the auto-update will fail. This is normal since Transifex checks the URL and sends out notifications whenever the URL isn't working.
Auto-updating a resource with Google Drive
The format of the URL for auto-updating a spreadsheet from Google Drive is as follows:
https://docs.google.com/spreadsheets/d/FILE_ID/export?format=xlsx
Auto-updating a resource with Microsoft Sharepoint
The format of the URL for auto-updating a file from Sharepoint is as follows:
https://mycompany.sharepoint.com/:w:/g/personal/username/FILE_ID?download=1
Using the API or command-line client to update source files
If you want to automate your localization process further, you can use Transifex's API or command-line client and integrate it with your build process. This way, you can automatically push updated content to Transifex and pull translated files when they are complete.
Similar to the UI, you can replace edited strings and keep existing translations when using the API and, specifically, the resource_strings_async_uploads endpoint.
To replace edited strings via API set
replace_edited_stringsto true.To keep existing translations, you can set the
keep_translationsparameter to true.
When using the Go CLI, just like the UI and API, you can replace edited strings and retain existing translations using the following options: --replace-edited-strings and --keep-translations.
What happens when you update files
A file is essentially a collection of strings. When you update a file and the option "Keep existing translations" is disabled, the following happens:
Identical strings that are in both the original file (e.g., file.po) and the updated file (e.g., file_v2.po) -> will remain in Transifex along with their translations.
New strings are added to Transifex -> These strings will appear as untranslated.
If a similar string was translated in the past, translators can use Translation Memory to help them translate the new string. If a 100% match is detected and Translation Memory autofill is enabled, all the previously submitted translations will be replicated within those new untranslated strings.
Strings from the original file are no longer present in the updated file -> These strings will not appear in Transifex.
If these strings were translated in the past, within the original file, the translation would be preserved in the Translation Memory.
Modified strings are added to Transifex.
In the case of a file with a key-value structure, two different scenarios might occur:
Modified strings (values/source text)
The text of an existing source string is modified, but the key remains the same.
e.g.
The initial version of the source string:
New version:
After updating the source file, Transifex will identify that your text has been modified, so the string's translation should be re-evaluated.
As a result:
Any previously submitted translation is removed from the translation area, and the string is considered untranslated.
The translation history of the string is being preserved and can be found under the History tab in the editor.
Any previously applied tags/instructions are preserved.
Any translatorsā comments are preserved.
Modified strings (keys/identifiers)
The key of an existing source string is modified, but the source text remains the same.
e.g.
The initial version of the source string:
New version:
After updating your source file:
The string with the modified key will be considered a completely new one.
Any comments/tags/history/translation of the previous entry will be lost since the entry with the previous version of the key is removed from your resource in Transifex.
However, the old translations are kept in your project's Translation Memory. So, if you have the feature "Fill up resources from TM" enabled, TM will detect the old strings and automatically kick in all the previously submitted translations if the match is 100%. If the match is not 100%, previous translations appear in the āSuggestionsā tab.
Here's a visual example. We have a source file with entities a, b, and c translated into two languages. Then we push an update with entity c removed and entity d added. The translated files are updated according to the new source file. In addition, the previous Italian translation (c ā c2) is saved in the TM.
š”Tip
Looking for more help? Get support from our Transifex Community Forum!
Find answers or post to get help from Transifex Support and our Community.