Skip to main content

XTM Connect – Contentful 1.11

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.

To configure file-merging and repeat occurrences of the same entry reference in a particular environment:
  1. 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.

  2. Select the relevant organization folder. The spaces it contains are listed.

  3. Select the relevant space and environment. When you select an environment, it is highlighted. The settings for that environment are displayed on the right.

  4. 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.