Look at our release notes to learn more about the development of Acrolinx for Oxygen Eclipse
This is a small service release to update our libraries and officially add support for Oxygen 25.
Acrolinx for Oxygen requires:
-
Acrolinx Platform version 2022.05 or later to highlight referenced content
-
If you want to check referenced content, but don’t care about highlighting the issues themselves, you’ll need Acrolinx Platform version 2021.12.1 or later.
-
-
23.x, 24.x, 25.x (Standalone and Eclipse)
-
Eclipse version 4.19 and above
In our Acrolinx for Oxygen 2.0 release, we made it possible to check referenced content within a DITA topic. With this release, we've enhanced it a little more. We're excited to introduce issue highlighting in referenced content! You'll also get a small UX improvement and a bug fix.
Acrolinx for Oxygen requires:
-
To highlight referenced content, you'll need Acrolinx Platform version 2022.05 or later.
If you want to check referenced content, but don’t care about highlighting the issues themselves, you’ll need Acrolinx Platform version 2021.12.1 or later.
-
22.x, 23.x, 24.x (Standalone and Eclipse)
-
Eclipse version 4.19 and above
Say goodbye 👋 to manually finding issues within DITA topics. Acrolinx now highlights these issues for you. When you click on an issue card in the Sidebar, Acrolinx will highlight and scroll to that issue in your content.
Improved Sidebar UXWhether you're an experienced user or you're just getting started with the Sidebar, a little extra UX help never hurts. We've added a new message to the Oxygen Sidebar that reminds you to open a document or file before you run a check.
Added Support for XIncludeWe can now check more of your content! We've added support for XInclude elements, which means that you can use Acrolinx to check, highlight, and replace issues in XInclude elements.
For this to work, you'll need the right Content Profile. XInclude is an external reference that isn’t editable with the Acrolinx Sidebar. That’s why XInclude references should be marked as READ_ONLY. Most Content Profiles include the setting for XInclude by default. If needed, you can set this yourself for Acrolinx for Oxygen 2.1.
To make sure you can check XInclude, do the following:
-
In the Acrolinx Dashboard, navigate to Guidance Settings > Content Profiles.
-
Find the DITA or XML Content Profile and click on it.
-
Go to Context and select READ_ONLY. (If the context READ_ONLY doesn’t exist, you need to create it. See the Content Profiles Reference Guide for more information.)
-
Click the plus icon and add
ACROLINX_EXTERNAL_CONTENTunder READ_ONLY. -
Under Extraction, add XInclude to the table as an empty element
In some cases, you would see a blank Acrolinx Sidebar when an unsupported version of Oxygen was used. This was confusing as it because it looked like a bug that wouldn't let you check your content. We’ve fixed this issue so that the Sidebar can't be installed on an unsupported version of Oxygen.
Danger
This is important if you're on Windows and use Oxygen Eclipse. It doesn't apply to Windows 11.
Windows users that aren't on Windows 11 and use Acrolinx for Oxygen Eclipse need to download and install WebView 2 from Microsoft. This is because we've updated the Sidebar to use Microsoft Edge Chromium instead of Internet Explorer.
You can download WebView 2 from the page WebView2 - Microsoft Edge Developer. Linux and macOS users don't need WebView 2.
We're excited to release the new Acrolinx for Oxygen. With version Acrolinx for Oxygen 2.0,we present the brand-new Sidebar batch checking feature. This feature lets you use the Sidebar to batch check DITA maps directly in your editing environment. Plus, you can now check for all issues in referenced content.
Acrolinx for Oxygen XML Editor and Author requires:
-
Acrolinx Platform version 2021.12 or later
-
Oxygen versions22.x, 23.x, 24.x (Standalone and Eclipse)
-
Eclipse Version 4.19 and above
We no longer support Acrolinx for Oxygen XML Editor and Author version 1.5.
We wanted to make it easy to keep an overview with the check results of a DITA map. So, we came up with a feature that lets you check a DITA map. On top of that, it accurately displays how each DITA topic within that map scores.
And voilà! You can batch check a DITA map and get an overview of each DITA topic's content quality directly in the Sidebar. From there, you can click the DITA topic cards to start taking action on the low-scoring DITA topics!
Learn more about how it works in Batch Check Your Content with the Sidebar.
Full Support for DITA ReferencesWith the Acrolinx for Oxygen 1.5 release, we made it possible to check for the following referenced content tags: conkeyref, conref, keyref, and topicref.
But we want it all! That's why you can now check all references within a DITA map. Note that checking referenced content works in the Author view only. In the Text view, Oxygen itself doesn’t resolve references.
Acrolinx for Oxygen is currently the only integration that resolves DITA references. So, don't be surprised if you get a slightly different score when you check the same content in a different integration, like the Content Analyzer.
Danger
This is important if you're on Windows and use Oxygen Eclipse. It doesn't apply to Windows 11.
Windows users that aren't on Windows 11 and use Acrolinx for Oxygen Eclipse need to download and install WebView 2 from Microsoft. This is because we've updated the Sidebar to use Microsoft Edge Chromium instead of Internet Explorer.
You can download WebView 2 from the page WebView2 - Microsoft Edge Developer. Linux and macOS users don't need WebView 2.