DITA and XMetaL Discussion

XMetaL Community Forum DITA and XMetaL Discussion Insert TopicRef using XMetaL8

  • jim.cain

    Insert TopicRef using XMetaL8

    Participants 2
    Replies 3
    Last Activity 7 years, 12 months ago

    Greetings,

    We are currently testing an upgrade from XMetaL6 to XMetaL8.  In the process of testing, we have encountered a difference that we would like clarification on.  Namely, in XMetaL6, we can insert a ditamap reference into a

    element resulting in markup.  In XMetaL8, using the “Insert Map Reference” option only results in markup.  In addition, using the “Insert Topic Reference” option is restricting us from choosing a ditamap (i.e., it only wants us to choose a topic).  Are we missing something?  Should we not be allowed to insert a ditamap into a map resulting in the following markup?

     

    Thanks,

    Jim

    Reply

    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.

    Reply

    jim.cain

    Reply to: Insert TopicRef using XMetaL8

    Thanks for the configuration info Derek!  That helps a lot!

    Is this configuration option something that we can build into our set of existing customizations that we have a separate installer for so that we do not have to manually set this for each user?

    Thanks again,

    Jim

    Reply

    Derek Read

    Reply to: Insert TopicRef using XMetaL8

    For versions 7, 8 and 9 this setting is remembered here:
    %appdata%SoftQuadXMetaLdita_options.xml

    And the value is recorded as:
    1.1

    Currently the only supported values are 1.1 and 1.2.

    Reply

  • You must be logged in to reply to this topic.

Lost Your Password?

Products
Downloads
Support