Error when using chunking with the webhelp transformation
Post here questions and problems related to editing and publishing DITA content.
-
- Posts: 24
- Joined: Fri Apr 05, 2013 11:01 pm
Error when using chunking with the webhelp transformation
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
-
- Posts: 24
- Joined: Fri Apr 05, 2013 11:01 pm
Re: Error when using chunking with the webhelp transformation
Spoke too soon!
- The search index is pulling topics that are part of a different pub that are filtered out by by @product!
- 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...)
-
- Posts: 24
- Joined: Fri Apr 05, 2013 11:01 pm
Re: Error when using chunking with the webhelp transformation
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.
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.
-
- Posts: 222
- Joined: Tue Jul 01, 2014 11:48 am
Re: Error when using chunking with the webhelp transformation
Post 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
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
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com
-
- Posts: 18
- Joined: Thu Feb 07, 2013 7:20 pm
Re: Error when using chunking with the webhelp transformation
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
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
-
- Posts: 9446
- Joined: Fri Jul 09, 2004 5:18 pm
Re: Error when using chunking with the webhelp transformation
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
Return to “DITA (Editing and Publishing DITA Content)”
Jump to
- Oxygen XML Editor/Author/Developer
- ↳ Feature Request
- ↳ Common Problems
- ↳ DITA (Editing and Publishing DITA Content)
- ↳ Artificial Intelligence (AI Positron Assistant add-on)
- ↳ SDK-API, Frameworks - Document Types
- ↳ DocBook
- ↳ TEI
- ↳ XHTML
- ↳ Other Issues
- Oxygen XML Web Author
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Content Fusion
- ↳ Feature Request
- ↳ Common Problems
- Oxygen JSON Editor
- ↳ Feature Request
- ↳ Common Problems
- Oxygen PDF Chemistry
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Feedback
- ↳ Feature Request
- ↳ Common Problems
- Oxygen XML WebHelp
- ↳ Feature Request
- ↳ Common Problems
- XML
- ↳ General XML Questions
- ↳ XSLT and FOP
- ↳ XML Schemas
- ↳ XQuery
- NVDL
- ↳ General NVDL Issues
- ↳ oNVDL Related Issues
- XML Services Market
- ↳ Offer a Service