Eclipse Help transformation problem

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

Eclipse Help transformation problem

Post by gwhite » Thu Nov 06, 2014 9:24 pm

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:
C:\DITA-OTProjectSettings\DITA-OT\plugins\org.dita.eclipsehelp\build_dita2eclipsehelp.xml:16: input file C:\Users\gwhite\Documents\Publishing\out\eclipsehelp-cos_Admin_Guide\cOSAdmin\cos_Admin_Guide.xml does not exist

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

Radu
Posts: 6812
Joined: Fri Jul 09, 2004 5:18 pm

Re: Eclipse Help transformation problem

Post by Radu » Fri Nov 07, 2014 9:50 am

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,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

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

Re: Eclipse Help transformation problem

Post by gwhite » Fri Nov 07, 2014 6:59 pm

Hi Radu,

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

Radu
Posts: 6812
Joined: Fri Jul 09, 2004 5:18 pm

Re: Eclipse Help transformation problem

Post by Radu » Sat Nov 08, 2014 9:26 am

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?
If so, please read this topic:

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,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

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

Re: Eclipse Help transformation problem

Post by gwhite » Wed Nov 12, 2014 12:25 am

I will do that. Thanks.

Post Reply