Skip to main content
Oct 15, 2015 8:18 PM UTC
Question

How to get nested mapref's to display in TOC correctly?

We have a ditamap with nested mapref's we are trying to get the nested mapref toc's to show at level 2 or the level below the mappref itself. We can't seem to do that does anyone have a suggestion?

6 replies

Oct 15, 2015 9:26 PM UTC

If you open the ditamap in Arbortext Editor and then open the document using Edit > Edit Resolved Document for Styling, do you see a hierarchy difference in the topics referenced from the top most ditamap and the ref'd ditamap?

smacleanAuthor
Oct 15, 2015 9:43 PM UTC

Tim, no they all appear at one level.

Oct 22, 2015 6:08 PM UTC

Ditamaps are containers of siblings, so a ditamap nested within a ditamap contains elements that are siblings to each other, and are also siblings to the content of the parent ditamap.

.

Nov 2, 2015 6:12 PM UTC

There are a couple of tags that affect the nesting, topicref and topichead are two of those. In both of these cases if you do not want that parent topicref to provide output, you might want to set toc=no, print=no so outputs will notice the hierarchy change, but not try to output any headers or such.

There are other elements that may also provide this, but those are the most common.

Note that you cannot nest a mapref inside of a mapref in DITA as that outcome is undefined.

smacleanAuthor
Nov 3, 2015 4:26 PM UTC

David,

Thanks for this, this helps.

Regards,

Stew Maclean

Nov 3, 2015 8:24 PM UTC

You are welcome. 🙂