Using Oxygen to Restructure DITA Files

Posts: 42

Using Oxygen to Restructure DITA Files

Thu Oct 27, 2016 11:32 pm

Greetings, all. I’m very new to Oxygen and have recently began using it to work on code-related issues in our DITA files. I’m undertaking a new project right now, and I wonder if there’s a tool in Oxygen that will help me overcome a large, time-consuming hurdle. I have a feeling there is – I’ve just yet to find it.

I’m charged with reorganizing our tech pubs repository filing structure. More to the point: creating a filing structure where none exists now. The current filing structure consists of one folder containing thousands of files (xml, ditamap, jpeg, png). I’m going to create an actual filing system. Very simply, the tree will look something like:

Repository Folder
+Subject A XML Folder
+XML Files
+Subject A Images Folder
+Subject B XML Folder
+XML Files
+Subject B Images folder

When I make this move, I’m going to cause chaos in the DITA files due to broken image links, etc. So the question is: Does Oxygen have a tool for re-linking orphaned files in mass?? I found and tinkered with the “Find Unreferenced Resources” Tool, but that didn’t have any effect on the image files within the individual topicref xml files within a ditamap.

Thanks for this and any other advice you may have on the subject of restructuring DITA files!
Posts: 5994

Re: Using Oxygen to Restructure DITA Files

Fri Oct 28, 2016 8:58 am


Unfortunately Oxygen does not yet have this kind of batch refactoring. We probably will add this in a future version though and I will update this thread when we do.
Until then you can probably try to use the Find/Replace in Files tool and try to batch replace references.

Radu Coravu
<oXygen/> XML Editor
Posts: 42

Re: Using Oxygen to Restructure DITA Files

Sat Oct 29, 2016 12:34 am

Thanks for your response. Your find/replace (in files) suggestion was very helpful.

Site Admin
Posts: 175

Re: Using Oxygen to Restructure DITA Files

Thu Apr 06, 2017 3:43 pm


I just wanted to let you know that in the newly released oXygen 19.0 we added the DITA Master Files Support, that allows you to easily move and rename resources (including non-topic files) in the Project view, and also update the references to those resources.

You can find some more information at

All the best wishes,
Sorin Carbunaru
oXygen XML

Return to “DITA (Editing and Publishing DITA Content)”

Who is online

Users browsing this forum: No registered users and 2 guests