Need to pass through resource files during webhelp transformation

Post here questions and problems related to editing and publishing DITA content.
Micaela Monroe
Posts: 29
Joined: Mon May 17, 2021 8:20 pm

Need to pass through resource files during webhelp transformation

Post by Micaela Monroe »

Hi there,

I have a bookmap that I am trying to publish to Webhelp Responsive. In my bookmap, I have a topicref that is pointing to a local HTML file (has format="html", scope="local"). That HTML file points to a bunch of different local resources that aren't coming through to the output. There are too many resources to add to the bookmap as resource-only.

Is there a way to designate a specific folder as a resource-only folder so that it passed through to the output? I've tried using the webhelp.custom.resources and args.resources, but neither seem to work. The resource files are embedded pretty far away from the bookmap. The bookmap is in the root folder and the resource files are 3 to 5 levels deep. I need to be sure to maintain the resource folder sub-folder structure because the HTML file I am passing through points to resources in different locations.

Thanks!
Micaela
radu_pisoi
Posts: 403
Joined: Thu Aug 21, 2003 11:36 am
Location: Craiova
Contact:

Re: Need to pass through resource files during webhelp transformation

Post by radu_pisoi »

Hi,

You can copy additional resources in the output folder either by declaring them as resource only in the root map or by using the webhelp.custom.resources parameter.

The webhelp.custom.resources parameter help you to copy all files from a directory to the root of the WebHelp output. So, it seems it is not very helpful for your use-case.

I will register an isssue on our side to find a solution for your use case. It could be an ANT extension point for WebHelp plugin that will allow you to copy a set of resources in the output folder at transformation time.
Radu Pisoi
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com
Micaela Monroe
Posts: 29
Joined: Mon May 17, 2021 8:20 pm

Re: Need to pass through resource files during webhelp transformation

Post by Micaela Monroe »

Thank you very much! For now this is kind of a one-off scenario and it works to copy and paste the resource folder and its sub-structure into the out folder. There's a chance we will need to integrate HTML files more often in the future so a new parameter could be really helpful.
Post Reply