Page 1 of 1

Multiple topics on WebHelp page

Posted: Wed Mar 20, 2019 2:17 pm
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.

Re: Multiple topics on WebHelp page

Posted: Thu Mar 21, 2019 3:09 pm
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

Re: Multiple topics on WebHelp page

Posted: Thu Mar 21, 2019 5:26 pm
by tct
Thank you very much, this was very helpful :)