Confusion about navtitle

[MarcB]

Using XMetaL Author Enterprise 12.0.0.057 on Windows 7 with default DITA version set to 1.2 in the DITA Options.

We are noticing the following behavior when including references to DITA maps from within a DITA map in conjunction with the @navtitle attribute. If the referenced DITA map is a regular map, XMetaL shows the value of the @navtitle attribute as before. If the referenced DITA map is a bookmap, the @navtitle attribute is ignored and the ID value of the referenced map is displayed.

Reference to a regular map:

Reference to a bookmap:

This happens with and alike, starting with XMetaL 12.

I understand the @navtitle is deprecated with DITA 1.2, but we have many DITA maps with that attribute, including nested DITA bookmaps, and they are now all displaying the Element ID as navtitle.
A workaround is to set the @locktitle attribute to “yes” on the topicref, but my question is: what should we be doing? What is the recommended format of a topic reference in a DITA map?

Thanks,
Marc Beckers
Software AG

Reply

[Author]

Posts