Administrator panel – Settings (file-merging)
For your instance of Contentful, use the settings below to configure file-merging and the handling of multiple occurrences of the same reference to an entry in the currently selected Contentful space:
If a translation project contains multiple source files, they can, if required, be merged into a single file, for translation. On delivery, this file will be split into its component individual files again, for upload to Contentful.
If a translation project contains multiple occurrences of the same reference to an entry, in a merged translation file, they can be handled differently, as detailed in the settings below.
In the Administrator panel, in XTM Connect, select the Settings tab. You see the Organization Settings section on the left of the Settings tab screen. It contains spaces and environments created for your organization.
Select the relevant organization folder. The spaces it contains are listed.
Select the relevant space and environment. When you select an environment, it is highlighted. The settings for that environment are displayed on the right.
In the File-merging section, make these settings:
File-merging setting
Description
Submit all links in one source file
Select one of the options in this dropdown to specify whether multiple content files are to be combined into a single translation file, when a specific translation project is created. If so, specify how this is to be done:
Do not merge files (default).
Merge all files into one: create a single, combined source file from all the content files.
Merge files separately by entry: send each content file for translation separately.
Allow user to decide checkbox
To permit a user (Translation requester) to decide whether multiple content files are to be combined into a single translation file, when a specific translation project is created, select this checkbox.
Handle multiple occurrences
Select one of the options in this dropdown to specify how multiple occurrences of the same reference to an entry are to be handled, in a merged translation file (if one is created, as defined in the options in row 1 of this table):
Only insert repeated text on first occurrence (default): even if a reference to an entry occurs more than once, in the content files, only insert it in the merged translation file once.
Insert duplicate each time text is repeated: if a reference to an entry occurs more than once, insert it in the merged translation file every time it occurs.
Warning
Warning: if Insert duplicate each time text is repeated is selected, the same text is displayed for translation in XTM Workbench multiple times, to give its context.
However, only the first occurrence of the text will be reimported to Contentful. There can only be one translation for one entry, no matter how often or where and how it is used.
Note
The settings you make for a specific environment (space), to control the merging of source files into a single translation file, or to handle multiple occurrences of the same reference to an entry, in a merged translation file, will only apply in that Contentful space.