Multiple Help Files for a ditamap...

[jojobar]

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]

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

[jojobar]

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

[jojobar]

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

[Radu]

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