CHM File and Files Outside Scope of the Input Dita/Map Directory
Posted: Sun Apr 07, 2019 8:05 am
Hi, Using <oXygen/> XML Author 21.0, build 2019022207, I created a ditamap and added several dita topics to it. These include one topic from outside the ditamap folder. I ran the DITA Map CHM transform and got the warning
[DOTJ036W] The file "file:/C:/oxygen_templates/outside_topic.dita" is outside the scope of the input dita/map directory
The warning would not be a concern, but there were also errors for the outside topic and for the other topics that are actually in the same folder as the ditamap:
Description: HHC5003: Error: Compilation failed while compiling ..\oxygen_templates\outside_topic.html.
Description: HHC5003: Error: Compilation failed while compiling another_topic.html.
Description: HHC5003: Error: Compilation failed while compiling topic_the_third.html.
A CHM file is created, but is completely nonfunctional. You can open it up, and the Contents list all the topics, but none of the topics open if you click on them. The right pane displays the message "This page can't be displayed."
If I delete the one outside topic reference from the ditamap and run the transform again, the warning and all the errors go away and I get a working CHM file where I can open the various topics.
It appears that for documents we plan to output to CHM, we will not be able to include any topics from outside the ditamap folder or its subfolders. Is this correct? It certainly makes it awkward to reuse topics in multiple documents.
Is there a workaround that I have overlooked? Thanks for any suggestions.
[DOTJ036W] The file "file:/C:/oxygen_templates/outside_topic.dita" is outside the scope of the input dita/map directory
The warning would not be a concern, but there were also errors for the outside topic and for the other topics that are actually in the same folder as the ditamap:
Description: HHC5003: Error: Compilation failed while compiling ..\oxygen_templates\outside_topic.html.
Description: HHC5003: Error: Compilation failed while compiling another_topic.html.
Description: HHC5003: Error: Compilation failed while compiling topic_the_third.html.
A CHM file is created, but is completely nonfunctional. You can open it up, and the Contents list all the topics, but none of the topics open if you click on them. The right pane displays the message "This page can't be displayed."
If I delete the one outside topic reference from the ditamap and run the transform again, the warning and all the errors go away and I get a working CHM file where I can open the various topics.
It appears that for documents we plan to output to CHM, we will not be able to include any topics from outside the ditamap folder or its subfolders. Is this correct? It certainly makes it awkward to reuse topics in multiple documents.
Is there a workaround that I have overlooked? Thanks for any suggestions.