[BUG] Webhelp Responsive chunking not working

Having trouble installing <oXygen/>? Got a bug to report? Post it all here.
caval
Posts: 25

Re: [BUG] Webhelp Responsive chunking not working

Tue May 02, 2017 7:26 pm

Fixed typos/added clarification:

I am running the webhelp plugin v19 in an external OT process.

Many topics in the ditamap are chunked (chunk="to-content").

In testing, when I ran the build from Oxygen on a local PC, the chunks were resolved correctly.

However, after I moved the OT to an external Linux server and ran the build from the command line, the chunks were ignored. No output is chunked.

The license file is valid, as noted in the output messages.

Details
- command: bin/dita -v -i "../../../../hudsonp/workspace/Webhelp/ug.ditamap" -f "webhelp-responsive" -propertyfile "build.properties"
- Oxygen Webhelp version 19.0, build number 2017042020
- OT version 2.3.3
- Linux version: RHEL 6
caval
Posts: 25

Re: [BUG] Webhelp Responsive chunking not working

Tue May 02, 2017 7:39 pm

More information from the output messages

The output messages include the following:
chunk-check:
chunk:

There is, however, no output under the chunk heading.

Conversely, when the build is run on the local PC from Oxygen, there are numerous lines under the chunk heading, such as the following:
[chunk] Writing file:/C:/ac/active/tmp/web/oxygen_dita_temp/Chunk911761557.dita
Costin
Posts: 437

Re: [BUG] Webhelp Responsive chunking not working

Wed May 03, 2017 11:31 am

Hi Caval,

This kind of problem might arise when the DITA Map is referencing one/some resource(s) (like: topics, other DITA Maps or even just an image) which could not be found in the same folder with the main DITA map, but might be outside of that folder.

For situations like such, we've created a parameter called "fix.external.refs.com.oxygenxml", which you could set to "true" in your DITA > WebHelp Responsive transformation scenario. This would tell oXygen to try to resolve any external references in a temporary folder prior to actually invoking the DITA OT on the references.

However, as this is not part of the DITA Open Toolkit but something we added externally to it, the "fix.external.refs" parameter is only available in the scenario's parameters, when you run the transformation scenario from the oXygen GUI. This can not also be used in the command line.
To set this parameter, you should edit the transformation scenario you are using (I think in your case this is "DITA Map WebHelp Responsive"), then look for it in the "Parameters" tab.

Have you perchance already set this parameter in your scenario? I am asking this as you specified that when you ran the build from Oxygen on a local PC, the chunks were resolved correctly.

Additionally, you should validate and check for completeness you DITA Map prior to running the DITA Map WebHelp Responsive scenario.
For that, you could use the "Validate and Check for Completeness" action in the toolbar of the DITA Maps Manager view. Once in the DITA Map Completeness Check dialog, make sure you have the "Report references to resources outside of the DITA map folder" option enabled. Then run the completeness check and this should help you see if you have missing resources in your DITA Map or resources located outside the Map's folder.

In case neither after checking from completeness and using the above mentioned parameter in the transformation scenario solves your issue and it still occurs, feel free to send us the sample files on our support email address for further investigation. The support email is support AT oxygenxml DOT com

Regards,
Costin
Costin Sandoi
oXygen XML Editor and Author Support
caval
Posts: 25

Re: [BUG] Webhelp Responsive chunking not working

Wed May 03, 2017 10:25 pm

Hi Costoi,

Thanks for your very cogent response.

I added fix.external.refs.com.oxygenxml=true to the properties file, but the chunks are still not created.

I also 1) validated the map and 2) created a very simple map as an alternate test -- in both cases the chunks are not created.

However, when I ran an Ant build, the chunks were created successfully.

I'll experiment more and may contact Support at that time.

Regards...

Return to “Common Problems”

Who is online

Users browsing this forum: Google [Bot] and 1 guest