Oxygen XML Author plugin 13.2.0

Author for DITA | 115Figure 66: Insert Topic Reference DialogBy using the Insert Topic Reference dialog you can easily browse for and select the source topic file. The Targetcombo box shows all available topics that can be targeted in the file. Selecting a target modifies the Href value to pointto it which corresponds to the href attribute of the inserted topicref element. The Format and Scope combos areautomatically filled based on the selected file and correspond to the format and scope attributes of the insertedtopicref element. You can specify and enforce a custom navigation title by checking the Navigation title checkboxand entering the desired title.The file chooser located in the dialog allows you to easily select the desired topic. The selected topic file will be addedas a child or sibling of the current selected topic reference, depending on the insert action selected from the contextualmenu of the DITA Maps view, that is an insert action from the Append child submenu or from the Insert after one.You can easily insert multiple topic references by keeping the dialog opened and changing the selection in the DITAMaps Manager tree. You can also select multiple resources in the file explorer and then insert them all as topic references.Another easy way to insert a topic reference is to drag files from the Project view, file system explorer or Data SourceExplorer view and drop them into the map tree.You can also define keys using the Keys text field on the inserted topicref or keydef element. Instead of usingthe Href combo box to point to a location you can reference a key definition using the Keyref text field. Use theChoose key reference to access the list of keys defined in the currently open DITA map.The Processing Role combo box allows setting the processing-role attribute to one of the allowed values forDITA reference elements: resource-only, normal, -dita-use-conref-target.Inserting a Topic HeadingThe topichead element provides a title-only entry in a navigation map, as an alternative to the fully-linked titleprovided by the topicref element.