Error when using chunking with the webhelp transformation

dagoss
Posts: 24
Joined: Fri Apr 05, 2013 11:01 pm

Error when using chunking with the webhelp transformation

Post by dagoss » Wed Oct 14, 2015 3:56 pm

I'm getting an error message when using the webhelp transformation on some composite dita files that were created using the docbook2dita stylesheets.

In the original DocBook publication, all of the sections were in <chapter> elements, with all sections in a single file. When this was converted automagically to DITA, it resulted in a nested <topic> per chapter. This results in one HTML page per chapter-level heading. To get around this, I have chunk="select-document by-topic to-navigation" set on the map so that 1 link per topic appears in the navigation tree.

/project/
/project/map.ditamap (with @chunk set)
/project/topics/
/project/topics/sectionname/topic1.dita (contains <dita> with nested topics)
/project/topics/sectionname/topic2.dita (contains <dita> with nested topics)
etc...

When I try to apply the webhelp transformation, I get the error message below (about 44 of them--they are all similar). When I look at the output dir, it's clear what causes the problem: the newly created chucks from my composite topic are in /, not /topics/ as it is expecting. Despite this and the error, the transformation apparently still works. I checked my output and all the topics that I'd expect are there, and I don't find any broken links in the navigation tree.

Is there a side effect of this error that I'm missing? Since my output appears to be correct, this seems like a false-positive.

System ID: X:\SVN\win-web-merge\generated_by_chunk)
Scenario: DITA-OT 1.7 (com.oxygen.webhelp) - WinLDMS
Input file: X:\SVN\win-web-merge\LDC_USRMAN003_WebLDMS.ditamap
Engine name: DITA-OT
Severity: error
Description: [DOTX031E]: The file file:/X:/SVN/win-web-merge/temp/ldmsManual/webhelp/topics/winldms/topics/whatIsLdms.d13e11.dita is not available to resolve link information. The location of this problem was at (File = generated_by_chunk)
URL: http://www.oxygenxml.com/DITA-messages. ... __DOTX031E

dagoss
Posts: 24
Joined: Fri Apr 05, 2013 11:01 pm

Re: Error when using chunking with the webhelp transformation

Post by dagoss » Wed Oct 14, 2015 4:25 pm

Spoke too soon!
  1. The search index is pulling topics that are part of a different pub that are filtered out by by @product!
  2. References to js and css in the chucked topics are to ../../oxygen-webhelp/, not oxygen-webhelp/ (I can fix that manually at deploy time, but still...)
In my experience, the webhelp transformation always seems to copy filtered output into the output directory, but it's not listed in the TOC nor does it appear in the search. Not sure if there is a way to manually fix #1.

dagoss
Posts: 24
Joined: Fri Apr 05, 2013 11:01 pm

Re: Error when using chunking with the webhelp transformation

Post by dagoss » Wed Oct 14, 2015 7:27 pm

This looks to be an OT issue in general (Also happened when using the dita4publishsers html5 transformation with OT 1.8.5).

Rather than trying to figure this, I decided to take the time to refactor my content to get rid of nested topics in the first place.

bogdan_cercelaru
Posts: 213
Joined: Tue Jul 01, 2014 11:48 am

Re: Error when using chunking with the webhelp transformation

Post by bogdan_cercelaru » Thu Oct 15, 2015 3:30 pm

Hello,

Have you checked if your generated DITA map passes validation in Oxygen?
You can check this as follow:
- open the DITA map in the DITA Maps Manager
- go to DITA Maps menu
- press "Validate and Check for Completeness"

Regards,
Bogdan
Bogdan Cercelaru
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com

cjbcjb
Posts: 18
Joined: Thu Feb 07, 2013 7:20 pm

Re: Error when using chunking with the webhelp transformation

Post by cjbcjb » Wed Dec 09, 2015 5:45 pm

I get the same message when for any cross-refs that are in a topic that has the Chunk attribute set to "to-content" or in a topic that is a subtopic of such a topic. For example: "[DOTX031E]: The file .../temp/oxygen_dita_temp/t_print_tab.dita is not available to resolve link information." The cross-ref to t_print_tab.dita is in a topic whose parent topic has the Chunk attribute set to "to-content".

I validated the map with no errors. Like the OP, the transformation finishes and there are no problems with the cross-refs. I'd like to eliminate these errors, nevertheless. Anyone else come across this and found a solution?

Chuck

cjbcjb
Posts: 18
Joined: Thu Feb 07, 2013 7:20 pm

Re: Error when using chunking with the webhelp transformation

Post by cjbcjb » Wed Dec 09, 2015 6:51 pm

Forgot to mention this just started after installing 17.1. I was on 17.0, which did not have this problem.

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

Re: Error when using chunking with the webhelp transformation

Post by Radu » Thu Dec 10, 2015 10:12 am

Hi Chuck,

I answered you here:

post36991.html#p36991

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

Post Reply