Multiple Help Files for a ditamap...

<oXygen/> general issues.
jojobar
Posts: 23
Joined: Wed Nov 02, 2016 9:01 pm

Multiple Help Files for a ditamap...

Post by jojobar » Wed Jul 03, 2019 5:07 am

Coming from a docbook background I am trying to get a handle on the dita format to convert all the help files to dita. I like the index page blocks that can be created using the "Responsive Webhelp" option.

My question is can I have different help files for a single ditamap file. For example, I have the separate user guide and installation manual that I want to show in the index.html file, however, when compiling I would like to compile them separately so that they create separate html and pdf file.

Radu
Posts: 6559
Joined: Fri Jul 09, 2004 5:18 pm

Re: Multiple Help Files for a ditamap...

Post by Radu » Wed Jul 03, 2019 9:26 am

Hi,

From one DITA Map you can obtain one logical output (one PDF or one WebHelp output).
If you have separate DITA Maps for your user's guide and installation guide, you can try to create a third DITA Map which refers to the other two DITA Maps and publish that to WebHelp.
But we do not have a tool which would take two separate WebHelp outputs and create a merged WebHelp output.

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

jojobar
Posts: 23
Joined: Wed Nov 02, 2016 9:01 pm

Re: Multiple Help Files for a ditamap...

Post by jojobar » Wed Jul 03, 2019 2:15 pm

I understand. Is it at least possible to have separate pdf files for different sections but have the unified responsive html?

jojobar
Posts: 23
Joined: Wed Nov 02, 2016 9:01 pm

Re: Multiple Help Files for a ditamap...

Post by jojobar » Wed Jul 03, 2019 2:23 pm

Also, can you point me to documentation or sample where I can combine two ditamap files into one?

Radu
Posts: 6559
Joined: Fri Jul 09, 2004 5:18 pm

Re: Multiple Help Files for a ditamap...

Post by Radu » Thu Jul 04, 2019 7:50 am

Hi,

If you want separate PDFs, you need to individually publish each DITA Map.
If you want merged HTMLs you need to create a top-level DITA Map which refers to all individual maps.
The XML content of the merged DITA Map should look like this:

Code: Select all

<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd">
<map>
    <title>Merged publication title</title>
    <topichead navtitle="First Map">
        <mapref href="map1.ditamap"/>
    </topichead>
    <topichead navtitle="First Map">
        <mapref href="map2.ditamap"/>
    </topichead>
</map>
documentation:

https://www.oxygenxml.com/doc/versions/ ... bmaps.html

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

Post Reply