Cleaning up a project

Post here questions and problems related to editing and publishing DITA content.
KatieKelly
Posts: 20
Joined: Thu Sep 10, 2020 11:22 pm

Cleaning up a project

Post by KatieKelly »

I have no idea which category of question this falls under, but since I edit and publish dita content I thought I'd start here.

I do not know if this is an Oxygen Editor, Author, or Developer question. I frankly get all three products confused. For years, I just managed everything in Editor. Everything was working pretty well until I upgraded to version 22. Now I have so many problems, I don't even know where to begin. But I thought I'd start with the most basic and go from there.

For several versions of our documentation (chm file and pdf), I have stored everything in one directory. I've kept everything organized using ditamap. I am not certain that this is the "correct" way, but it's seemed the most intuitive. I have no idea how to set up a project file.

One of my problems (out of many) is that it seems that in this directory are now an untold number of files that are no longer in use. They could be xml, dita, or even image files. My question is, is there a feature in Oxygen that can show me which files are no longer in use, so I can clear them out of the directory?

This is actually one of many problems I have to solve, but it seems like I can't solve any of them until I narrow this part down first.

Thanks much!

-Katie
sorin_carbunaru
Posts: 417
Joined: Mon May 09, 2016 9:37 am

Re: Cleaning up a project

Post by sorin_carbunaru »

Hello Katie,

The Developer does not have support for editing DITA in the Author page, so you definitely don't want that one. The Author is what technical writers normally use, but it does not have the best support for customizing the publishing by using XSLT, for example. The Editor is Author + Developer. So, if you don't mind the extra functionality that is geared towards XML development, you can stick with the Editor without any worries.

Now, in regards to Oxygen projects, you could check out the following:
- The Using Projects to Group Documents chapter from our userguide: https://www.oxygenxml.com/doc/versions/ ... jects.html.
- This older webinar: https://www.oxygenxml.com/events/2016/w ... jects.html.

I would say that working with projects in Oxygen is the way to go.

When it comes to finding resources that are not used anymore in DITA content, the Find Unreferenced Resources action comes in handy. You can find more information about it in our user manual: https://www.oxygenxml.com/doc/versions/ ... urces.html.

All the best wishes,
Sorin Carbunaru
Oxygen XML Editor
KatieKelly
Posts: 20
Joined: Thu Sep 10, 2020 11:22 pm

Re: Cleaning up a project

Post by KatieKelly »

Thank you!
Post Reply