XMetaL Tips and Tricks

XMetaL Community Forum XMetaL Tips and Tricks XMetaL® Author Enterprise 15.0 Release Notes

  • nhu1

    XMetaL® Author Enterprise 15.0 Release Notes

    Participants 0
    Replies 0
    Last Activity 1 year, 8 months ago

    XMetaL® Author Enterprise 15.0 Release Notes


    XMetaL Author is the leading authoring application for organizations using any XML document type, including the most complete support for the Darwin Information Typing Architecture, or DITA. XMetaL Author also helps you maximize content reuse through tight integration with content repositories, and address advanced publishing requirements with an extensible publishing framework.

    With this version, XMetaL Author introduces a robust quick navigation feature, Markdown support, improved document management in tag groups, a Whiteboard toolbar that provides a convenient way to get to and define your favorite and frequently used actions, a new way to quickly correct or replace words, and a new version availability notification. For a complete list of new features, see New features.

    New features

    Quick XMetaL navigation

    The Quick XMetaL Navigation tool allows you to easily find and use any command you can run. It includes context-sensitive search, grouping, sorting and filtering as well as customization options.

    In finding and opening documents, and in viewing recently used and opened documents, you can now view the document titles of recently used and favorite documents and find and open documents by title, file name or the content of specific XML document elements.

    Markdown support

    XMetaL now supports Markdown syntax. You can write documents in Markdown as well as convert documents into Markdown and convert Markdown documents into HTML and Docx.

    XMetaL whiteboard

    This release of XMetaL Author Enterprise includes a new XMetaL whiteboard feature that provides a convenient way to get to and define your favorite and frequently used actions, and gives you control of customizable quick access buttons in the toolbar.

    Favorite actions can include calls to third-party applications where the parameter can contain a path, word under cursor, or selected text in an active document. XMetaL includes examples, some of which show how to, for example, find selected text on the web or pass text to free web translation services.

    Managing documents in tab groups

    You now have more control over the opening, closing and viewing of documents in a tab group in an XMetaL pane.

    The editing pane now also includes a quick access menu for active files.

    Quick word correction/replacement

    A writing tool for correcting or replacing a word under the cursor, activated by hot key, has been updated.

    New version availability notification

    XMetaL can now provide a notification when a new version or an update to the current version is available.

    Zoom in or out

    XMetaL now supports zoom in or out on XML content using View->Zoom in/out menu and keyboard shortcuts for more comfortable reading.

    Third-party components

    This version of XMetaL Author Enterprise embeds the following third-party components, used for generating output from XML content (publishing):

    • DITA Open Toolkit Releases 3.3.4, 2.4.4, and 2.0. The default setting is for XMetaL to use DITA OT 3.3.4. DITA OT 3.2.1 is excluded and can be distributed via additional web installer. Please refer to the 3rd-party software’s website for more details: http://sourceforge.net/projects/dita-ot/

    Known issues

    Tools > Options dialog accelerators don’t work sometimes

    Some property pages within the new unified options dialog won’t respond to keyboard shortcuts until focus is moved into the embedded XFT form that is on the active property page. This limitation relates to Windows’ handling of embedded ActiveX controls.

    Generate Output fails if filenames or paths contain a mix of Polish characters and spaces

    The DITA Open Toolkit included with the software fails to generate output if any of the filenames or paths contain Polish characters AND spaces. The only workaround at this time to adhust filename and paths to exclude spaces OR put all the files into the same folder.

    Docking action indicators don’t display in the correct location on systems with text size set to something other than 100%

    With the introduction of High-DPI support in Windows Vista, certain settings can cause the application to not render properly. In particular, setting a text size value to something other than 100% can result in the application having drawing issues when resizing a docking panel or moving it to another docking location.

    To workaround this issue, adjust the custom text size settings so that the system uses Windows XP scaling (Windows Vista and Windows 7).

    Shortcut key doesn’t work after moving focus to Map Editor with XMetaL Navigator

    Shortcut key doesn’t do anything after moving focus into the Map Editor using the XMetaL Navigator feature. To work around this, please press the <Tab> key once and try your keyboard shortcut again. If it still doesn’t work repeat pressing <Tab> key and trying your shortcut key until you get some action.

    WebHelp output’s Print function doesn’t work for local files

    When opening a local copy of the WebHelp output into a web browser, especially Google Chrome, clicking the “Print” button results in no action. This behavior is typically the result of a web browser’s “same-origin” security model for local files versus files loaded over http.

    This behavior can be worked around by running a local web server or deploying the WebHelp webhelp_out folder’s contents to a web server and navigating your browser to that web server location.

    DITA for Publishers outputs are disabled

    The D4P outputs (i.e. Kindle, ePub, et al) are currently disabled because the plugin is not compatible with the DITA Open Toolkit version integrated with XMetaL. The timeframe for a new D4P plugin release is not known at this time.

    When using DITA 1.3 XML schemas, reusable component feature is disabled

    XMetaL’s reusuble component feature has not been setup for the DITA 1.3 XSDs. As a result, related menu items like Reuse > Create Reusable Component are disabled.

    WebDAV lock cannot be obtained for document just opened

    When a document is opened from a WebDAV server into XMetaL Author Enterprise, an error message maybe displayed stating that the WebDAV lock could not be obtained. This issue is due to the DITA MapEditor feature preprocessing the document’s XML with our XMetaL XML processor (XMXML). XMXML contains a lot of the same code as XMetaL Author including the WebDAV locking logic and as such, XMXML ends up obtaining the WebDAV lock first.

    To work around this issue, the DITA options must be changed so that ditamap files open into the XML view by default. To change this setting, select the Tools > Options… menu item and select the DITA category’s Map Editor tab. On the Map Editor tab, adjust the “Open DITA maps in the:” dropdown list so that “XML view” is selected. Click OK to accept the changes and restart XMetaL.

    Note: The DITA feature does not support WebDAV out-of-the-box. A WebDAV capable XMetaL connector is required to use the DITA feature with a WebDAV server.

    The x64 Cameras In Focus and Meeting Minutes samples have some features that don’t work

    A few of the Cameras In Focus and Meeting Minutes sample’s features rely upon Microsoft components that do not have an x64 equivalent (e.g. MSScript.ocx, MSCAL1.ocx). Yet other features rely upon a x64 version of Microsoft Word to be installed on the computer. In the x64 version of the software, these samples have been removed from the Help > Samples submenu to avoid issues. You can still invoke either samples template but please use caution when running these samples as they may not gracefully degrade when invoking features with a dependency on these 3rd party items.

    Built-in toolbar auto-layout on first launch

    When XMetaL Author is started for the first time, the built-in toolbars will each be docked on a separate row. Custom DTD-specific toolbars will be docked more efficiently (i.e. multiple per row) providing there is enough horizontal space to do so. Once toolbars have been reorganized (by dragging them around), their positions will be remembered. This vertically oriented auto-layout for built-in toolbars will also take effect any time the XMetaL Author workspace is reset, which is done by holding the Ctrl key down at startup.

    Child submenus/menu items not copied when moving top-level menu buttons

    Moving top-level menu buttons will not copy the child submenus or menu items. Similarly, moving submenu items will not duplicate those child items.


  • You must be logged in to reply to this topic.

Lost Your Password?