Introduction

Below are the most common problems clients put forward report in tickets with regard to the concerning XTM Visual mode in XTM Workbench.

...

Issue description & Solution

InDesign font is squeezed or malformed

...

Solution: This often happens occurs when no font files are uploaded in the Preview Preview Files  after the project creation stage. To correct this, please follow the steps below:

1. Upload font files in the the Preview Files Files section of your Project editor → General info page and Save the changes.

...

...

2. If the step above does not improve the display,

...

2. create a

...

2. suitable ticket

...

2. for the XTM International Support team and send your fonts along with your request.

Note
IMPORTANT! Please, note Note that all alterations adjustments to the XTM Visual Mode will be displayed in a new project. In old projects, due to Visual Mode mechanicsthe way XTM Visual mode works, only the displayed target section of the mode content will be changed, while the . The source part will remain unchanged until the project 's reanalysisis reanalyzed.

Fonts in the preview and XTM Visual

...

mode are malformed for Chinese/Japanese/Korean languages in an IDML file

...

Solution: If for Chinese/Japanese/Korean languages you experience malformed font, then it the font is malformed, in the case of Chinese, Japanese or Korean, this most likely means that your source document contains a font that does not support those languages. In such a case, please, raise create an XTM support International Support ticket and send us your IDML file that is utilizing fonts that are desirable for you for a given language, in which the fonts you require for a particular language are used. We will extract language data from such files and perform re-mappingremapping.

XTM Visual

...

mode is not

...

being displayed for DITA/XML files

Solution: If it is your first time you are r uploading DITA/XML files for the first time, chances you are you likely to have XTM Visual Mode mode disabled for those files disabled. In such a case, please, send a ticket to the XTM International Support team requesting the establishment enabling of XTM Visual Mode for the mentioned specified file extensions.

Note
IMPORTANT! Please, Also note also that if you have previously requested previously XTM Visual Mode for DITA /or XML files with specific root nodes, then, if you introduce add files with a different root node, the support Support team will have to alter your XTM Visual Mode configuration once again to make it work.

Images are not displayed in XTM Visual Mode

Solution: When uploading files to the Preview files section, please, make sure that:

• They are in one of the allowed permitted formats: JPG, GIF, PNG, SVG;

• They are properly referenced in the source document (e.g. in DITA, src="images/text_picture.jpg" means that you have to upload a zipped images folder zipped images folder with text_picture.jpg in it);

• Images are zipped , and their overall total size does not exceed 150MBs150MB.

• Paths in the source file and the path in the preview files folder are the same.

  • To display the Links panel, choose Window → Window → Links in InDesign. Each linked file and automatically embedded file is identified by name. Clicking If you click on a given particular graphic, you will show display the Link info: name for it in the Links panel.

  • Alternatively, you could open XTM Visual Mode mode → (right-click on it) → Inspect → find the image that is not displayed and try to read its name in the Elements tab. Beware that there might be some special characters that will be encoded differently.

  • Once you have found out the missing file’s file's name, you can check if it was sent in the Preview files. If it was, you can also unpack your IDML source file and use , open Notepad++ and use the Find in files feature to search for the file’s file's name (or its part of it). Perhaps there is some minor difference between the name in preview and name in the source file.

As far as InDesign files are concerned, in order to properly display their images properly in the XTM Visual Mode mode and in preview files, you also need to upload relevant files in the the Preview Files section   in the project's general information tab. Please, click here See Uploading preview files for InDesign projects to learn all the prerequisites.

Some parts of the text in XTM Visual Mode are not clickable

Solution: Due to security reasons, XTM Cloud is blocking content that, mainly in HTML source files, is linked to a JavaScript code. Please, review Check if your source file if it contains JavaScript code or is referring to an external sheet (which is in most cases uploaded in preview files), and if . If so, please, consider deleting it or altering the document before submitting it as an XTM Cloud project.

Difference in content between source file and XTM Visual Mode

Solution: Please, keep Keep in mind that XTM Visual Mode mode aims to be a 1:1 representation of the source document. If some parts of the document are not visibly exposed visible in the file (e.g. attributes in the HTML source, InDesign style nodes , or alternate content in a DOCX file), then it will not be represented displayed in XTM Visual Modemode. 

Also, if you requested for some ITS configurations to be established, parts that have been blocked from or exposed to translation this in that way will not be available in XTM Visual Modemode.

Source and target is misaligned in XTM Visual Mode

Solution: This issue mostly occurs in InDesign. The Apply the following method can be applied to avert resolve the problem.

The page does not change due to InDesign moving the segment to another page. It probably occurs probably because there is not enough space to contain this node on the current page to contain this node. However, the segment remains on the same page for source preview , therefore, so it is not changed.

In this situation, in order to change the page, you can unlink the source from the target by clicking the button next to the option to change the page:

...