Oxygen XML Author plugin 13.2.0

Predefined Document Types | 145Figure 82: Insert a cross reference in a DITA document• Key Reference - Inserts a user specified element with the value of attribute keyref attribute set to a specific keyname. As stated in the DITA 1.2 specification keys can be defined at map level which can be then referenced. Thetarget of the keyref is selected in a dialog which lists all the keys available in the current opened map from theDITA Maps Manager.You can also reference elements at sub-topic level by pressing the Sub-topic button and choosing the target.Important: All keys which are presented in the dialog are gathered from the current opened DITA map.Elements which have the keyref attribute set are displayed as links. The current opened DITA map is alsoused to resolve references when navigating keyref links in the Author mode. Image elements which usekey references are rendered as images.• File Reference - Inserts an xref element with the value of attribute format set to xml.• Web Link - Inserts an xref element with the value of attribute format set to html, and scope set to external.• Related Link to Topic - Inserts a link element inside a related-links parent.• Related Link to File - Inserts a link element with the format attribute set to xml inside a related-linksparent.• Related Link to Web Page - Inserts a link element with the attribute format set to html and scope set toexternal inside a related-links parent.Note: The actions for inserting references described above are grouped inside link toolbar actions group.• Paste as Link (available on the contextual menu of Author editor for any topic file) - Inserts a link element or anxref one (depending on the location of the paste) that points to the DITA XML element from the clipboard. Anentire DITA XML element with an ID attribute must be present in the clipboard when the action is invoked. Thehref attribute of link/href will point to this ID value.• Paste as Content Reference (available on the contextual menu of Author editor for any topic file) - Inserts a contentreference (a DITA element with a conref attribute) to the DITA XML element from the clipboard. An entire DITAXML element with an ID attribute must be present in the clipboard when the action is invoked. The conref attributewill point to this ID value.•Insert Section / Step - Inserts a new section / step in the document, depending on the current context. A newsection will be inserted in either one of the following contexts:• section context, when the value of class attribute of the current element or one of its ancestors contains topicor section.• topic's body context, when the value of class attribute of the current element contains topic/body.