Webhelp not generating expandable books

jeofree
Posts: 5
Joined: Tue May 03, 2011 5:54 am

Webhelp not generating expandable books

Post by jeofree » Tue Mar 13, 2012 2:13 pm

I'm fairly new to Oxygen after having tried it a while back, so this might be something obvious, bear with me if so:

When I generate Webhelp from a dita map, I'm just getting a list in the nav frame at the left when I publish, with no hierarchy or expandable sections or books. I've tried building both a book map and a dita map as the top level, but the result seems to be the same.

What I'm looking for is how to generate something that looks like this:

http://www.oxygenxml.com/doc/ug-oxygen/ ... -dita.html

and what I'm generating looks more like what I see on page 255 of the Oxygen XML Editor 13.2 PDF manual I'm reading, just a list of topics with no indentation or indication about what's a map reference and what's a topic, no expanding of sections to reveal topics, and so on.

Can someone explain how to create the hierarchical, expandable nav tree in Webhelp using Oxygen?

Thanks very much,

sorin_ristache
Posts: 4144
Joined: Fri Mar 28, 2003 2:12 pm

Re: Webhelp not generating expandable books

Post by sorin_ristache » Tue Mar 13, 2012 4:17 pm

Hello,

The tree of topic references from the left side frame of the Webhelp output in a browser must be the same as the tree of topic references from the DITA map displayed in the DITA Maps Manager view, for example:

Code: Select all

<bookmap id="com.oxygenxml.usermanual" collection-type="sequence">

...

<chapter href="topics/installation.dita" collection-type="sequence">
<topicref href="topics/installation-requirements.dita" collection-type="sequence">
<topicref href="topics/platform-requirements.dita" collection-type="sequence"/>
<topicref href="topics/operating-system.dita" collection-type="sequence"/>
<topicref href="topics/environment-requirements.dita" collection-type="sequence">
<topicref href="topics/tools.dita" collection-type="sequence"/>
<topicref href="topics/environment-pre-requisites-standalone.dita"
product="editor author svnClient diff developer" collection-type="sequence"/>
<topicref href="topics/environment-pre-requisites-eclipse.dita"
product="editorEclipse authorEclipse developerEclipse" collection-type="sequence"/>
</topicref>
<topicref href="topics/installation-JWS-requirements.dita" product="editor author developer"/>
</topicref>
<topicref href="topics/installation-instructions.dita"

...

</bookmap>
If your topics are organized as a list in the map in the DITA Maps Manager view then it will also be a list in the output in the browser, that is no expandable sections/books, for example:

Code: Select all

<bookmap id="com.oxygenxml.usermanual" collection-type="sequence">
...
<chapter href="topics/introduction.dita"/>
<chapter href="topics/installation.dita"/>
<chapter href="topics/getting-started.dita"/>
...
</bookmap>
What is the structure of your DITA map? Is it a list or a tree? If it is a tree please send a zip archive with some sample files (a DITA map and the topics that are included in the map) for testing the Webhelp transformation on your DITA map in Oxygen. In what browser are you loading the Webhelp?


Regards,
Sorin

jeofree
Posts: 5
Joined: Tue May 03, 2011 5:54 am

Re: Webhelp not generating expandable books

Post by jeofree » Tue Mar 13, 2012 4:56 pm

Thanks Sohn,

That steered me in the right direction, I've got it working now.

I was using nested ditamaps, because that's what I had used on a different project once (not using Oxygen) but it's easier to just use parts, chapters, and topics and once I did, it came out the way I wanted. I'm sure it's possible to use nested ditamaps also but not the way I was doing it, clearly, but this is better anyway.

Thanks again,

Post Reply