Page 1 of 1

Using Oxygen to Restructure DITA Files

Posted: Thu Oct 27, 2016 11:32 pm
by 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!

Re: Using Oxygen to Restructure DITA Files

Posted: Fri Oct 28, 2016 8:58 am
by 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

Re: Using Oxygen to Restructure DITA Files

Posted: Sat Oct 29, 2016 12:34 am
by thedantanner
Thanks for your response. Your find/replace (in files) suggestion was very helpful.

Cheers.
Dan

Re: Using Oxygen to Restructure DITA Files

Posted: Thu Apr 06, 2017 3:43 pm
by 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