Acrolinx for JustSystems XMetaL - Version 1.0 (28 April 2017)
The Sidebar for Acrolinx for XMetaL offers you a new way of checking and correcting your content. Learn more about the differences between the two editions in the article Acrolinx Plug-ins Now Come In Two Editions—What's the Difference? .
Manage Extraction Settings on the Server
In the Acrolinx classic edition, you could configure the extraction settings in the plug-in. For the Sidebar, you can configure the extraction settings in the Acrolinx server. This also offers you the option to set specific guidelines for working with attributes. Your guidance package includes default Context Segmentation Definition (CSD) and context definition files, especially for XMetaL. You'll need to update to a new guidance package or get these files from Acrolinx and install them separately. See the article Configuring Server-side Extraction for more information. If you'd like help converting your extraction settings contact Acrolinx Support. They'll be more than happy to help.
Sidebar Appears in the Resource Manager
The Sidebar loads in the resource manager pane on the left side of the XMetaL Author. If you prefer, you can move the Sidebar by drag and drop to the right side of the screen. And you can adjust the pane to show the Sidebar in its fixed dimensions.
Use Acrolinx in Different XMetaL Editor Views
You can use Acrolinx in plain Text, Normal, and Tags On views.
Supported File Types
Acrolinx supports DITA and XML document formats. Supported file types include concept, reference, task, topic, troubleshooting, dita, glossentry, and glossgroup.
Tracked Changes Support
You can use tracked changes in the Tags On and the Normal view. If you turn on tracked changes, Acrolinx will highlight suggestions that you accept as tracked changes. Acrolinx ignores content that's tracked for deletion.
Before You Update Remove Classic Edition
You need to remove the Acrolinx classic edition before you install the Sidebar edition. A parallel installation of both classic and Sidebar editions of Acrolinx isn’t possible.
Request a new license to get the Sidebar activated for your server.
Specify the Address of an Acrolinx Server with an MSI Installer Property
If your administrator uses the MSI installer properties to automate the installation of Acrolinx, they can also now specify the address of an Acrolinx server. So, writers don't have to enter this information themselves. To set that Acrolinx server address, use the property ACROLINX_SERVER_ADDRESS.
Enable Cross-origin Resource Sharing (CORS)
To use Acrolinx for XMetaL sidebar edition, you’ll need to enable CORS on your Acrolinx server. See the article Setting up the Acrolinx Sidebar.
Using Acrolinx with XMetaL 10 Requires Update to Windows Registry
If you use version 10, you must update a key in your Windows registry. Otherwise, you won't be able to show the Acrolinx sidebar. See Why won't the Acrolinx Sidebar load on XMetaL 10? for more details.
Sidebar Cards for Variables Become Deactivated
Acrolinx can read content from variables in your documents. However, by design, variables are read-only because the information is preset and often populated during printing. If the issue cards appear for variables, the cards don't get the "read-only" padlock icon. Instead, if you click a card, then the card becomes deactivated.
Cards for Issue Text with Mixed Formatting Become Deactivated When Clicked
As mentioned in the comment above, Acrolinx doesn't support mix formatted text. So, if you click on the card of such highlighted text, the card will be deactivated.
Sidebar Doesn't Appear after Successful Installation
On some Windows 8.1, we've observed that the Sidebar doesn’t load when you select Load Sidebar from the Acrolinx menu. If you encounter this, try adding file://127.0.0.1 to the trusted site list of Internet Explorer settings.
Sidebar Cards Become Deactivated and Acrolinx Doesn’t Select Issue Text
If Acrolinx finds an issue for a text longer than 248 characters, clicking on the Sidebar card results in deactivating the card. That's because XMetaL API has a limitation that prevents Acrolinx from selecting long spans of text. This issue occurs in versions 10, 11, and 12.0.0.047. XMetaL version 12.0.0.057 allows selection of longer texts. Install that update to avoid this issue.
We've developed and tested this version of Acrolinx with XMetaL versions 10, 11 and 12.
The plug-in requires the following Acrolinx products:
- Acrolinx server version 5.1 or later
- Acrolinx guidance package version 5.1 or later
- Acrolinx sidebar version 14.2 or later.