Configuring Visual mode in AEM 6.5
Note
If you are using AEM as a Cloud Service (AEMaaCS), see Configuring Visual mode in AEMaaCS.
When a source content page is sent to XTM Cloud, for translation, from Adobe Experience Manager 6.5, additional reference files can be sent with it, if required. Later, a Project Manager or Linguist can use these additional reference files to display a complete preview of the source content, in XTM Workbench. This preview, called Visual mode, is proprietary to XTM International.
To identify these additional reference files, the source content page contains in-line references to them. These reference files are sent with the source content (which is to be translated), but in a separate preview package (ZIP file). For more details, see How does Visual mode work? (AEM 6.5).
Note
If the joining function is enabled in a project, it is not possible to enable or use Visual mode in that project, in XTM Workbench. For details about the joining function, see Implementing support for the DITA standard (AEM 6.5) in this Guide.
Restrictions on preview generation
In some cases, the assets required for preview generation might not be added to the preview package ZIP file correctly. For details, see Restrictions on preview generation in Visual mode (AEM 6.5).
Visual mode configuration tasks
To enable Project Managers or Linguists to use Visual mode to preview content, when they are using or translating in XTM Workbench, the way Visual mode handles Adobe Experience Manager 6.5 content needs to be configured in Adobe Experience Manager 6.5. Refer to the table below for details of where to make the necessary settings.
Warning
Configuring Visual mode can be a complex task. The instructions below provide guidelines to performing configuration tasks but it is essential to prevent any impact on working production systems. It is the responsibility of users who are implementing Visual mode to ensure that it works properly and has no negative effects on their overall Adobe Experience Manager instance.
For these reasons, we strongly recommend that you experiment and test configurations on a local development environment, to speed up configuration. You might require multiple adjustments. Avoid using deployments, which can result in frustration.
The proper approach is Develop → Test → Roll out to lower environments → Roll out to Production.
Task | See topic... |
|---|---|
Enable Visual mode in Adobe Experience Manager 6.5. NoteTo enable XTM Workbench to display content previews in Visual mode, Visual mode must be enabled in the Adobe Experience Manager 6.5 Configuration Manager. This configuration is part of a package, so the procedure described in the linked topic (on the right of this cell) does not normally need to be performed manually. | Enabling Visual mode in AEM 6.5 (if required: see Note in Task column). |
Customize the XTM Workbench Path variable for Visual mode | For details, see XTM Workbench Path variable customization for Visual mode. |
Define replacement match patterns to change content in fetched preview files. | Replacement match patterns section in Configuring preview filters for Visual mode in AEM 6.5. |
Define replacement strings to change content in fetched preview files. | Replacement strings section in Configuring preview filters for Visual mode in AEM 6.5. |
Exclude unwanted reference files from preview packages, if required. | Reference filters section in Configuring preview filters for Visual mode in AEM 6.5. |
Include particular additional types of source content file in projects sent to XTM Cloud for translation, if required. | Custom HTML reference patterns section in Configuring preview filters for Visual mode in AEM 6.5. |
Specify whether particular client libraries should always be included in preview packages. | Force inclusion of client library categories section in Configuring preview filters for Visual mode in AEM 6.5. |
Disable generation of data-previewnodepath attributes. These attributes control the way that content is exported to XTM Workbench, for use in Visual mode. They are used to affect the way that text selected in Visual mode, in XTM Workbench, is highlighted. This highlighting is called text decoration. It is based on the Visual mode decorating algorithm. | Enabling Visual mode in XTM Workbench (AEM 6.5) in the Translation Cloud Services Advanced settings. |