Page Comparison

...

Why are some inline tags grouped? Why are there inline tags missing at the beginning or end of the segment?

Inline tag grouping in XTM Cloud is a feature designed to minimize the number of inline tags displayed in a segment, so Linguists can concentrate on translation without worrying about tag placement. This feature is enabled by default and can be disabled globally, per file extension, without affecting TM matching, and does not require reanalysis.

Similarly, the hiding of leading and trailing inline tags is another feature intended to improve the translation experience. This can also be disabled globally, per file extension. Both features deactivate automatically if the grouped or hidden inline tags inserted in a translation or match are in a different order from the source file. However, it's important to note that leading and trailing inline tags cannot be hidden in segments with internal matches.

Which file formats can XTM Cloud process?

Visit the following XTM Cloud help page, to see what file formats are supported, for translation in XTM Cloud: Language codes (select your XTM version and search for the phrase: Language codes).

What should I do if the target file fails to generate or does not look as expected?

If the target file fails to generate or does not look as expected, this could be for several reasons. One common issue is the misplacement or lack of inline tags, which can cause target file generation to fail. To troubleshoot this, you can check if XTM Cloud is able to provide a reason for the failure by selecting Project Editor → Files → (select the relevant target language) → Target → (click on the red exclamation mark icon). If the message does not tell you what is wrong with the file, you can create a simple TEST project that is exactly the same as your original one and try to generate the target file there. If the target file still has the same problem, you should also check for any misplaced inline tags and try again.

Another issue could be that the target has been generated but will not open due to misplaced inline tags. To search for misplaced inline tags, select Project editor → General info → General info, find the QA profile and edit it to deselect all checkboxes except for the Order of inline tags is changed or content is missing between inline tags in target segment checkbox in the Other section. Then, run the QA for the document, setting it to only list segments with warnings and review the segments to find any inline tags whose order has been changed incorrectly.

If target generation runs but never ends, this is likely to be due to stuck queues. In this case, you should raise a ticket with the XTM International Support team, on our Support Portal and provide the necessary information.

Lastly, if the target does not generate at all, the problem could be caused by headers. This issue is associated with the Initialization error in XTM Workbench. The solutions to this problem include reanalysis of the whole project or manual repair of the issue. More about it in this article: XTM Workbench – most common issues & troubleshooting.

What does the “not supported - without workflow” information mean in a project’s workflow?

...

This message means that the file intended for analysis is not supported by XTM Cloud. All the supported files formats are listed in Which file formats can XTM Cloud process?.

Can XTM Cloud process plural forms/ICU plural syntax, etc.?

Yes, XTM Cloud can localize plurals in several file formats including Android XML, DITA files, JSON with ICU syntax, PO/POT and stringdict. However, by default, plural localization is disabled. Plurals are grouped in keyword categories for naming forms: zero, one, two, few, many, and other. The other form is always required as it is used for something that does not match any other category.

How do I use a filter template in a project?

To use a filter template in a project, follow these steps:

1. Open the project in the Project Editor.

2. Select the General info tab.

3. In the General info section, select the required filter template from the Filter template dropdown.

4. Select Save to close the Project Editor.

5. In the Project list, find the required project, click on its context’s menu, and select Actions → Reanalyze project.

...

If the project has already been created, you can choose a filter template from the same dropdown in the project’s General info section. Remember to Save the change at the bottom of the page.

...

Inline tags in XTM are grouped together by default if they are bundled together. If during an initial analysis a TM match that has inline tags is populated to the target segment and the tags position themselves in a way that does not satisfy the grouping mechanism, they will be ungrouped. However, once the tags are moved next to each other again in the XTM Workbench session, the criteria for grouping tags are then satisfied and so redundant tags are removed.

Similarly, the hiding of leading and trailing inline tags is another feature intended to improve the translation experience. It can also be disabled globally, per file extension. Both features deactivate automatically if the grouped or hidden inline tags inserted in a translation or match are in a different order from the source file. However, it is important to note that leading and trailing inline tags cannot be hidden in segments with internal matches (Repetitions and Fuzzy Repetitions).

Which file formats can XTM Cloud process?

Visit the following XTM Cloud help page, to see what file formats are supported, for translation in XTM Cloud: Language codes (select your XTM version and search for the phrase: Language codes).

What should I do if the target file fails to generate or does not look as expected?

If the target file fails to generate or does not look as expected, this could be for several reasons. One common issue is the misplacement or lack of inline tags, which can cause target file generation to fail. To troubleshoot this, you can check if XTM Cloud is able to provide a reason for the failure by selecting Project Editor → Files → (select the relevant target language) → Target → (click on the red exclamation mark icon). If the message does not tell you what is wrong with the file, you can create a simple TEST project that is exactly the same as your original one and try to generate the target file there. If the target file still has the same problem, you should also check for any misplaced inline tags and try again.

Another issue could be that the target has been generated but will not open due to misplaced inline tags. To search for misplaced inline tags, select Project editor → General info → General info, find the QA profile and edit it to deselect all checkboxes except for the Order of inline tags is changed or content is missing between inline tags in target segment checkbox in the Other section. Then, run the QA for the document, setting it to only list segments with warnings and review the segments to find any inline tags whose order has been changed incorrectly.

If target generation runs but never ends, this is likely to be due to stuck queues. In this case, you should raise a ticket with the XTM International Support team, on our Support Portal and provide the necessary information.

Lastly, if the target does not generate at all, the problem could be caused by headers. This issue is associated with the Initialization error in XTM Workbench. The solutions to this problem include reanalysis of the whole project or manual repair of the issue. More about it in this article: XTM Workbench – most common issues & troubleshooting.

What does the “not supported - without workflow” information mean in a project’s workflow?

...

This message means that the file intended for analysis is not supported by XTM Cloud. All the supported files formats are listed in Which file formats can XTM Cloud process?.

Can XTM Cloud process plural forms/ICU plural syntax, etc.?

Yes, XTM Cloud can localize plurals in several file formats including Android XML, DITA files, JSON with ICU syntax, PO/POT and stringdict. However, by default, plural localization is disabled. Plurals are grouped in keyword categories for naming forms: zero, one, two, few, many, and other. The other form is always required as it is used for something that does not match any other category.

How do I use a filter template in a project?

To use a filter template in a project, follow these steps:

1. Open the project in the Project Editor.

2. Select the General info tab.

3. In the General info section, select the required filter template from the Filter template dropdown.

4. Select Save to close the Project Editor.

5. In the Project list, find the required project, click on its context’s menu, and select Actions → Reanalyze project.

...

If the project has already been created, you can choose a filter template from the same dropdown in the project’s General info section. Remember to Save the change at the bottom of the page.

If you do not want to reanalyze the whole project, you can always upload a new file to it via the Files tab screen. This file can be added to the ones that are already present or replace one of them. In this case, only newly uploaded files are analyzed with new configuration rules. If you upload a file with the same name and extension as one of the source files, it will overwrite the content of the previous file during analysis.

...

Most of the value of the “supposeThatHttpdHasTwoHashValues" parameter is contained in between underscore characters, whereas the value of the "supposeThatHttpdHasTwoHashValuesH1AndH2" parameter is not. You might have a special configuration applied in your filter template which converts anything between underscore characters into an inline tag. You can then see them in the { } Inline tags section, in XTM Workbench.

...

Considering the above, make sure to first review the configuration of your filter template and do not hesitate to contact the XTM Support team in case of any doubts/questions.

Why is my source file rendered as having “no content” after project analysis even though there is some translatable content in the file?

...

In the vast majority of cases, the lack of content extracted from the source file might stem from an incorrect Filter Template that has been applied to the project. For this reason, make sure to first review the Filter Template used in this project. If you are not sure of the Filter Template’s settings, do not hesitate to contact the XTM Support team for help.

Is it possible to exclude highlighted parts of the text in MS Word files from translation in XTM Cloud?

Naturally, it is possible to exclude highlighted parts of the text in MS Word files from translation in XTM Cloud. Contact the XTM International Support team to have it configured for you on the back-end side of your XTM instance. In a JSM request, provide a sample source file with highlighted text, which shall be excluded from translationunderscore characters into an inline tag. You can then see them in the { } Inline tags section, in XTM Workbench.

...

Considering the above, make sure to first review the configuration of your filter template and do not hesitate to contact the XTM Support team in case of any doubts/questions.

Why is my source file rendered as having “no content” after project analysis even though there is some translatable content in the file?

...

In the vast majority of cases, the lack of content extracted from the source file might stem from an incorrect Filter Template that has been applied to the project. For this reason, make sure to first review the Filter Template used in this project. If you are not sure of the Filter Template’s settings, do not hesitate to contact the XTM Support team for help.

Is it possible to exclude highlighted parts of the text in MS Word files from translation in XTM Cloud?

Naturally, it is possible to exclude highlighted parts of the text in MS Word files from translation in XTM Cloud. Contact the XTM International Support team to have it configured for you on the back-end side of your XTM instance. In a JSM request, provide a sample source file with highlighted text, which shall be excluded from translation.

Why am I seeing certain text in XTM Workbench twice, from MS Word source files?

When translating in XTM Workbench, you might wonder why certain text is displayed in the editor twice. This is because of the existence of the so-called alternate content which is by default taken for translation by XTM (unless configured otherwise on your instance by the XTM International Support team). Such content is often a string of text that is contained within charts' or images' descriptions or within text boxes.

Take a look at the following screenshot which presents two segments, the first of which (70) is actual content and the second one (82) is its alternate content.

...

For more information about the alternate content, see: How are segments in MS Office files (Word, Excel, PowerPoint) extracted?.

How does XTM process newline tags? What does it look like in XTM Workbench and can I decide where to put them in the target text?

When your source file contains a newline tag (\n), such as in the Today is a \n sunny day., in the XTM Workbench, this text will appear as: today is a sunny day. Here, the \n tag is displayed as a whitespace character.

By default, XTM Cloud does not break segments on newline tags. The entire text remains in one segment, with the newline tag rendered as a white space.

However, we can configure XTM Cloud to handle newline tags in other ways, based on your preference:

1. Break Segments on \n:

   • If configured, the \n will cause the text to be split into separate segments in XTM Workbench. For example:

     • Segment 1: Today is a

     • Segment 2: sunny day.

2. Display \n as an Inline Tag:

   • We can make the \n visible as an inline tag rather than displaying it as a whitespace character. This allows the linguist to see the newline explicitly and decide where to place it in the target segment, while translating the text in XTM Workbench.

Why are some elements/fields/tags that exist in my source file absent from the target file?

XTM Cloud should retain all elements/fields/tags that exist in the source file, regardless of whether or not they are eligible for translation in XTM Workbench. If you state that some nodes from your source file are missing in the target file that you generated in XTM Cloud, it means that there are two possible scenarios:

1. The data in question is absent from your source file in the first place, in which case you should double-check if this is truly the case. It might happen that clients overlook that fact when preparing source files for translation.

2. There might be an issue on the XTM Cloud side that would need fixing. In such a case, once you have made sure that your source file does contain the nodes in question, do not hesitate to contact the XTM International Support team and describe the problem.