problem with rendering Webhelp using a DITA map that references DITA files in other locations
Posted: Thu May 19, 2016 5:39 pm
Hi:
I was testing the Webhelp transformation with Oxygen yesterday, and came across a problem: if I create a DITA map file ( a bookmap file to be exact) that topic-references DITA files that are not in the same directory as the DITA map file, although Oxygen could still transform files to Webhelp, but when you click the topic from the dropdown menu in Webhelp (that is: the topic whose source file is located outside the DITA map directory), the link would not work. Yet if all the topic files are located in the same directory as the DITA map file, Oxygen would transform a flawless Webhelp output. Is it that I might not have followed the DITA best practice? Or is it a problem with Oxygen's webhelp output mechanism? If the problem is the former, then I would say isn't DITA map supposed to work that way - referencing topics that are located anywhere, and not limited to topics that are located in the same directory?
Just to give you an idea, here is a bare bone structure of my DITA map:
When Oxygen transformed these files to Webhelp, the links to 1.dita to 7.dita did not work, any input is appreciated.
I was testing the Webhelp transformation with Oxygen yesterday, and came across a problem: if I create a DITA map file ( a bookmap file to be exact) that topic-references DITA files that are not in the same directory as the DITA map file, although Oxygen could still transform files to Webhelp, but when you click the topic from the dropdown menu in Webhelp (that is: the topic whose source file is located outside the DITA map directory), the link would not work. Yet if all the topic files are located in the same directory as the DITA map file, Oxygen would transform a flawless Webhelp output. Is it that I might not have followed the DITA best practice? Or is it a problem with Oxygen's webhelp output mechanism? If the problem is the former, then I would say isn't DITA map supposed to work that way - referencing topics that are located anywhere, and not limited to topics that are located in the same directory?
Just to give you an idea, here is a bare bone structure of my DITA map:
Code: Select all
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE bookmap PUBLIC "-//OASIS//DTD DITA BookMap//EN" "bookmap.dtd">
<bookmap>
<booktitle>
<mainbooktitle>ditamap test</mainbooktitle>
<booktitlealt class="- topic/ph bookmap/booktitlealt ">test</booktitlealt>
</booktitle>
<bookmeta>
<authorinformation>
<organizationinfo class="+ topic/data xnal-d/organizationinfo ">
<namedetails class="+ topic/data xnal-d/namedetails ">
<organizationnamedetails/>
</namedetails>
<addressdetails class="+ topic/ph xnal-d/addressdetails "><thoroughfare
class="+ topic/ph xnal-d/thoroughfare "/><locality><localityname
class="+ topic/ph xnal-d/localityname "/></locality><administrativearea
class="+ topic/ph xnal-d/administrativearea "/><locality><postalcode
class="+ topic/ph xnal-d/postalcode "/></locality>
<country class="+ topic/ph xnal-d/country "/></addressdetails>
<contactnumbers>
<contactnumber class="+ topic/data xnal-d/contactnumber "/>
</contactnumbers>
</organizationinfo>
</authorinformation>
<metadata>
<prodinfo>
<prodname></prodname>
<vrmlist>
<vrm version="1.0"/>
</vrmlist>
</prodinfo>
</metadata>
</bookmeta>
<frontmatter>
<booklists>
<toc/>
</booklists>
</frontmatter>
<chapter>
<topicref href="chapter.dita">
<topicref href="chapter1.dita"/>
<topicref
href="../%my_dir%/1.dita"/>
<topicref href="../%my_dir%/2.dita"/>
<topicref href="../%my_dir%/3.dita"/>
<topicref href="../%my_dir%/4.dita"/>
<topicref href="../%my_dir%/5.dita"/>
<topicref href="../%my_dir%/6.dita"/>
<topicref href="../%my_dir%/7.dita"/>
</topicref>
</chapter>
<backmatter>
<booklists>
<indexlist/>
<figurelist/>
<bibliolist/>
</booklists>
</backmatter>
</bookmap>