History | Edit

The references to entities, XInclude, DITA conrefs, and constructs in other vocabularies with displayable referenced content are expanded by default in Author mode and the referenced content is displayed. You can control this behavior from the Author preferences page. The referenced resources are loaded and displayed inside the element or entity that references them, but the displayed content cannot be modified directly in current document.

Figure: XInclude reference

Figure: External entity reference

When the referenced resource cannot be resolved, an error will be presented inside the element that refers them instead of the content.

If you want to make modifications to the referenced content, you must open the source where the referenced resource resides. The referenced resource can be opened quickly by clicking the link (marked with the icon) that is displayed before the referenced content or by using the Edit Reference action from the contextual menu (in this case, the cursor is placed at the precise location where the action was invoked). The referenced resource is resolved through the XML Catalog set in the XML Catalog preferences page.

The referenced content is refreshed as follows:
  • Automatically, when it is modified and saved from Oxygen XML Editor.
  • On demand, by using the Refresh references action. This is useful when the referenced content is modified outside the Oxygen XML Editor scope.