Page 1 of 1

Error when using chunking with the webhelp transformation

Posted: Wed Oct 14, 2015 3:56 pm
by dagoss
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

Re: Error when using chunking with the webhelp transformation

Posted: Wed Oct 14, 2015 4:25 pm
by dagoss
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.

Re: Error when using chunking with the webhelp transformation

Posted: Wed Oct 14, 2015 7:27 pm
by dagoss
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.

Re: Error when using chunking with the webhelp transformation

Posted: Thu Oct 15, 2015 3:30 pm
by bogdan_cercelaru
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

Re: Error when using chunking with the webhelp transformation

Posted: Wed Dec 09, 2015 5:45 pm
by cjbcjb
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

Re: Error when using chunking with the webhelp transformation

Posted: Wed Dec 09, 2015 6:51 pm
by cjbcjb
Forgot to mention this just started after installing 17.1. I was on 17.0, which did not have this problem.

Re: Error when using chunking with the webhelp transformation

Posted: Thu Dec 10, 2015 10:12 am
by Radu
Hi Chuck,

I answered you here:

post36991.html#p36991

Regards,
Radu