Error when using chunking with the webhelp transformation
Posted: 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
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