## Eclipse Help transformation problem

gwhite
Posts: 70
Joined: Fri Jul 27, 2012 1:46 am

### Eclipse Help transformation problem

I'm trying to generate Eclipse Help for my library of user documentation, with the goal of uploading all the plugins to a documentation library on the company intranet. I'm getting this error when running the transform (taken from the log):

Code: Select all

BUILD FAILED
C:\DITA-OTProjectSettings\DITA-OT\build.xml:56: The following error occurred while executing this line:

Total time: 12 seconds

The process finished with exit code: 1

The file cos_Admin_Guide.xml does exist, but not in the cOSAdmin folder -- it's in the folder above that with all the html files, the plugin.xml file, and so on. Why does the build fail -- why is Oxygen looking for that file in the wrong place?

Gary

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

### Re: Eclipse Help transformation problem

Hi Gary,

You seem to be using a custom DITA Open Toolkit installation so I'm not sure what changes you made to it.
Did you copy it from an Oxygen installation? If so, from what Oxygen version did you copy it?

Basically an Eclipse Help transformation must be applied on a DITA Map. Is the cos_Admin_Guide.xml file a DITA Map or a topic?
If it is a topic, please try to apply the publishing on a DITA Map which refers to the topic.
If it's a DITA Map maybe you should try renaming it with the ditamap extension, the DITA Open Toolkit might have problems with this.

Also the DITA Open Toolkit has always had problems when a DITA Map references resources which are outside of the folder where the map is located. So this might be another possibility of why this fails for you:

http://www.oxygenxml.com/doc/ug-oxygen/ ... -refs.html

Regards,
<oXygen/> XML Editor
http://www.oxygenxml.com

gwhite
Posts: 70
Joined: Fri Jul 27, 2012 1:46 am

### Re: Eclipse Help transformation problem

The DITA-OT I use was simply copied from its location in the /frameworks/dita folder in Oxygen (I think version 15.0 or perhaps 14.1) to the root of my hard drive in order to make small changes that don't get overwritten with a new installation. I mainly customize the appearance of PDFs, and for this I use a Customization folder. As for this Eclipse Help transformation, I can't think of anything I've done to customize its operation. The cos_Admin_Guide.xml file is only a file in the output folder, along with two other .xml files named after ditamaps referenced in the ditamap I'm running the transform on, cOS_Admin_Guide.ditamap. Those xml files in output essentially detail the other ditamaps' tables of contents. I was expecting to see an index.html file in output that would launch the help system, but there's no such file.

I'm wondering whether there is an attribute on the ditamap I need to set, or something else involved in order to get a functioning Eclipse Help?

Gary

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

### Re: Eclipse Help transformation problem

Hi Gary,

Basically for Eclipse Help output you would just need to open the main DITA Map in the DITA Maps Manager view and apply the corresponding transformation scenario to it.
I'm not sure what the problem is, it might be related to the structure of your DITA Map project, for example does the master DITA Map refer to resources which are outside of its folder?

http://www.oxygenxml.com/doc/ug-editor/ ... -refs.html

If not, maybe you can send us (support@oxygenxml.com) a sample project to investigate the problem on our side.

Regards,