Home Forums DITA and XMetaL Discussion Insert TopicRef using XMetaL8 Reply To: Insert TopicRef using XMetaL8

Derek Read

Reply to: Insert TopicRef using XMetaL8

The element was introduced with DITA 1.2 and when authoring to the DITA 1.2 DTDs the Insert > Map Reference option will insert it. The DITA 1.2 specs define it as a “convenience element that is equivalent to a element with the format attribute set to “ditamap”. I don't believe they say that it must be used in place of but we did alter the dialogs and logic to insert it when selecting Insert > Map Reference.

XMetaL Author Enterprise version 6 did not support the DITA 1.2 DTDs and did not have any special logic to deal with the insertion of elements for that version of the DITA DTDs.

If you enable authoring to the DITA 1.1 DTDs in version 7, 8 or 9 you should see the same old behaviour as version 6 (the same old logic should be used together with the 1.1 DTDs). In versions 7, 8 and 9 the version of DITA you are authoring to is configurable in Tools > DITA Options on the “General” tab and defaults to using the DITA 1.2 DTDs, together with updated dialogs and logic to deal with those DTDs.

If you do need to author to DITA 1.2 then you will need to leave that setting at “1.2”, and in that case you will see the UI that corresponds with authoring to DITA 1.2 and associated functionality, including the insertion of elements.