Webhelp graphics directory problem

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

Webhelp graphics directory problem

Post by gwhite » Thu Dec 06, 2012 7:53 pm

Hi,

When I produce Webhelp output for my DITA project, the graphics folder ends up outside the webhelp folder, in a folder named after the project/product and on the same level as webhelp. There must be a setting causing this, but I can't find it. The graphics display as expected if I simply move the graphics folder under the webhelp folder.

Any ideas would be appreciated.

Thanks,

Gary

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

Re: Webhelp graphics directory problem

Post by Radu » Fri Dec 07, 2012 9:57 am

Hi Gary,

Is it possible that in one of your DITA topics you are referencing resources (topics or images) which are located in a folder placed outside of the folder where the published DITA Map is located?
The DITA Open Toolkit does not handle such cases very well and might try to move folders around in the output folder in order to have all references properly resolved.

If this is the problem, you can try to fix it in two ways:

1) Create a DITA Map which is located in a folder which is an ancestor of all folders from which you are using content and resources. Refer from this DITA Map to the other one and publish this top-level DITA Map instead.

2) Edit the transformation scenario and in the Parameters tab edit the fix.external.refs.com.oxygenxml parameter and set it to true. This is a parameter we added especially for such situations.

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

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

Re: Webhelp graphics directory problem

Post by gwhite » Fri Dec 07, 2012 6:19 pm

Yes, that scenario is true of my data. I have a conref folder at the level of all folders that contain ditamaps. This folder contains only one file, which includes conrefs for all product names in the documentation. I'll try the fix involving the transformation parameter.

I asked previously, and didn't get an answer, about importing such a file by reference into all the folders with ditamaps. Some CMSs have this import-by-reference feature. That would solve the problem quite elegantly, but I don't know if oXygen has this capability.

Thanks!

Gary

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

Re: Webhelp graphics directory problem

Post by Radu » Fri Dec 07, 2012 6:29 pm

Hi Gary,
I asked previously, and didn't get an answer, about importing such a file by reference into all the folders with ditamaps. Some CMSs have this import-by-reference feature. That would solve the problem quite elegantly, but I don't know if oXygen has this capability.
We do not have such a feature. Sorry if you did not get an answer from us the first time, I do not know what happened.

Another trick you could try would be to have a topic in the current DITA Map folder hierarchy which makes a conref to that external located topic (so the entire useful content would still be in one place). This might work because conrefs are resolved at the pre-processing stage.

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

Post Reply