Opening Dita map with deeply nested submaps

Posts: 6
Joined: Mon May 20, 2019 5:24 pm

Opening Dita map with deeply nested submaps

Post by krishna » Tue Jul 16, 2019 11:13 am


We have created a plugin for Oxygen and in that, we are trying to open a DITA Map having deeply nested submaps and Oxygen opens the map in the editor only after all the deeply nested submaps have been resolved.

We actually want to open the map in the editor by resolving only the first level submaps (i.e display the contents of first level submaps only and not the content of deeply nested submaps) and resolve the further nested submaps upon expanding the first level submaps.

So, is there any API or configuration in Oxygen which will allow us to achieve this behavior?


Posts: 7024
Joined: Fri Jul 09, 2004 5:18 pm

Re: Opening Dita map with deeply nested submaps

Post by Radu » Wed Jul 17, 2019 9:34 am

Hi Krishna,

The DITA framework has a Java extension which performs these DITA Map map reference expansions in the Author visual editing mode.

In our Oxygen Maven-based Author SDK you should find the java sources for our "" class and you would need to make changes to it to achieve what you want.
To do this, you would need to create a framework customization.
So in the Oxygen Preferences->"Document Type Association" page you would need to extend the "DITA Map" framework and save the extension somewhere on disk: ... aring.html

Then in your framework extension in the "Classpath" tab you would need to add a reference to an extra JAR library located in your framework extension folder and containing your own "my.custom.DITAMapRefResolver" implementation.
Then in the "Extensions" tab you would set the "References resolver" extension to refer to your implementation.

Once you have a "DITA Map" framework extension you can share it with others as an add-on. Or you can provide it from an Oxygen plugin: ... nsion.html

Radu Coravu
<oXygen/> XML Editor

Posts: 315
Joined: Mon May 09, 2016 9:37 am

Re: Opening Dita map with deeply nested submaps

Post by sorin_carbunaru » Wed May 20, 2020 12:37 pm


Just wanted to update this thread and let you know that in Oxygen 22.1 we added the Expand references to other maps when opening a map in Author mode option in the DITA preferences page. It can be deactivated for faster opening maps with a lot of submaps in the Author page. The option makes its effect when the map is reopened in the Author page.

Best wishes,
Sorin Carbunaru
oXygen XML

Post Reply