Introduction
Below are the most common problems clients put forward in tickets with regard to the XTM Visual mode.
Prior to reading the content of this article, you may want to get familiar with the following article in order to find out more about translating in XTM Visual mode: How to translate in XTM Visual Mode. |
Issue description & Solution
InDesign font is squeezed or malformed
Solution: This often happens when no font files are uploaded in the Preview Files after the project creation stage. To correct this, please follow the steps below:
Upload font files in the Preview Files section of your Project editor → General info page and Save the changes.
2. If the step above does not improve the display, please, raise a proper ticket to the XTM Support team and send your fonts along with your request.
IMPORTANT!
Please, note that all alterations to the Visual Mode will be displayed in a new project. In old projects, due to Visual Mode mechanics, only the target section of the mode will be changed, while the source part will remain unchanged until the project's reanalysis.
Fonts in the preview and 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 most likely means that your source document contains a font that does not support those languages. In such a case, please, raise an XTM support ticket and send your IDML file that is utilizing fonts that are desirable for you for a given language. We will extract language data from such files and perform re-mapping.
Visual Mode is not opening up for DITA/XML files
Solution: If it is your first time uploading DITA/XML files, chances are you have Visual Mode for those files disabled. In such a case, please, send a ticket to the XTM Support team requesting the establishment of Visual Mode for the mentioned file extensions.
IMPORTANT!
Please, note also that if you requested previously Visual Mode for DITA/XML files with specific root nodes, then if you introduce files with a different root node, the support team will have to alter your Visual Mode configuration once again to make it work.
Images are not displayed in Visual Mode
Solution: When uploading files to the Preview files
section, please, make sure that:
They are in one of the allowed 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 with text_picture.jpg in it);Images are zipped, and their overall size does not exceed 150MBs.
Paths in the source file and the path in the preview files folder are the same.
To display the Links panel, choose Window → Links in InDesign. Each linked file and automatically embedded file is identified by name. Clicking on a given graphic will show Link info: name for it in the Links panel.
Alternatively, you could open Visual Mode → (right-click on it) → Inspect → find the image that is not displayed and try to read its name in the Elements tab. Beware there might be some special characters will be encoded differently.
Once you have the missing 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 Notepad++ and use the Find in files feature to search for the file’s name (or its part). 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 in the Visual Mode and in preview files, you also need to upload relevant files in the Preview Files section in the project's general information tab. Please, click here to learn all the prerequisites.
Some parts of the text in Visual Mode are not clickable
Solution: Due to security reasons, XTM is blocking content that, mainly in HTML source files, is linked to a JavaScript code. Please, review 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 so, please, consider deleting it or altering the document before submitting it as an XTM project.
Difference in content between source file and Visual Mode
Solution: Please, keep in mind that Visual Mode aims to be a 1:1 representation of the source document. If some parts of the document are not visibly exposed in the file (e.g. attributes in the HTML source, InDesign style nodes, alternate content in DOCX), then it will not be represented in Visual Mode.
Also, if you requested for some ITS configurations to be established, parts that have been blocked from or exposed to translation this way will not be available in Visual Mode.
Source and target is misaligned in Visual Mode
Solution: This issue mostly occurs in InDesign. The following method can be applied to avert the problem.
The page does not change due to InDesign moving the segment to another page. It occurs probably because there is not enough space on the current page to contain this node. However, the segment remains on the same page for source preview, therefore, 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: