Content Re-Use

Displaying Resolved DITA Content in the Editor

The XML content referenced with DITA conrefs are presented in-place as a read-only block that can be collapsed or expanded. Therefore, Oxygen shows you a picture of the entire XML document with all the XML references resolved.

DITA Conref

In this screenshot, a referenced XML element is selected. If you need to edit the content of a referenced element, you can click on the link that is positioned before it. Oxygen will open the file and place the cursor at the beginning of the referenced element.

There is an Open Map in editor with resolved topics action available on the root of the DITA map, when opened in the DITA Maps Manager. This action opens the map in the editor with all the referenced topics and maps expanded in-place, thus displaying a preview of the published result.

Support for Content References

Content referencing is a convenient DITA mechanism for content re-use from other topics or maps. You can easily insert direct references (conref) or indirect references (conkeyref) in a DITA document using the Reuse Content action (available on the toolbar and in the contextual menu). It allows you to choose the source of the reusable content and target ID of specific elements within the source.

Insert DITA Conref dialog

There is also support for inserting content references through the Conref Push mechanism. Oxygen also supports inserting direct and related links, based on cross references, file references, or Web links, and includes other helpful actions for working with content references and reusable components.