Using Oxygen to Restructure DITA Files

[thedantanner]

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
+Images
+Subject B XML Folder
+XML Files
+Subject B Images folder
+Images

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!

[Radu]

Hi,

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.

Regards,
Radu

[thedantanner]

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

Cheers.
Dan

[sorin_carbunaru]

Hello,

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 https://www.oxygenxml.com/doc/versions/ ... r%2Cfiles.

All the best wishes,
Sorin Carbunaru
oXygen XML