Multiple topics on WebHelp page

Post here questions and problems related to editing and publishing DITA content.
tct
Posts: 3
Joined: Wed Mar 20, 2019 12:29 am

Multiple topics on WebHelp page

Post by tct »

Hello folks,

I'm currently evaluating whether DITA with WebHelp output is a good replacement for our current documentation system. Thanks to OxygenXML Editor and the corresponding documentation getting everything up and running was a walk on the beach.

My question: How can configure WebHelp to show multiple topics on the same page? I'm referring to something like this: https://www.oxygenxml.com/dita/1.3/spec ... __contains
I tried to find the source code of that documentation but it seems like that's not available. Could someone tell me how I can achieve this effect? Are those just sections in a topic?

It would be very helpful if there would be a few real world sample documentations (like the one linked) with the corresponding DITA source files.
cosmin_andrei
Posts: 145
Joined: Mon Jun 12, 2017 10:50 am

Re: Multiple topics on WebHelp page

Post by cosmin_andrei »

Hello,

Thank you for contacting us!

In order to achieve this, you can use the DITA chunking mechanism as following (you should use the chunk="to-content" attribute set on the parent topic):

Code: Select all

<topicref href="concepts/springFlowers.dita" collection-type="sequence" chunk="to-content">
<topicref href="topics/flowers/iris.dita"/>
<topicref href="topics/flowers/snowdrop.dita"/>
</topicref>

You can find below a few links to useful resources:
https://www.oxygenxml.com/dita/1.3/spec ... nking.html
https://www.oxygenxml.com/dita/1.3/spec ... mples.html
https://www.oxygenxml.com/dita/1.3/spec ... tails.html
Regards,
Cosmin
--
Cosmin Andrei
oXygen XML Editor and Author Support
tct
Posts: 3
Joined: Wed Mar 20, 2019 12:29 am

Re: Multiple topics on WebHelp page

Post by tct »

Thank you very much, this was very helpful :)
Post Reply