Displaying Referenced Content
The references to entities, XInclude, and DITA conrefs 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 refers them, however the displayed content cannot be modified directly.
XInclude reference
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 referenced
resource in an editor. 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 in the main file). The referenced resource is resolved through
the XML
Catalog set in Preferences.
The referenced content is refreshed:
- Automatically, when it is modified and saved from Oxygen XML Author.
- On demand, by using the Refresh references action. Useful when the referenced content is modified outside the Oxygen XML Author scope.