Displaying referred content

The referred content (entities, XInclude, DITA conref, etc) will be resolved and displayed by default. You can control this behavior from the Author options page.

The referred resources are loaded and displayed inside the element or entity that refers them, however the displayed content cannot be modified directly.

 

Figure 5.16. XInclude reference

XInclude reference

 

Figure 5.17. External entity reference

External entity reference

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

 

Figure 5.18. Unresolvable XInclude reference

Unresolvable XInclude reference

If you want to make modifications to the referred content, you must open the referred resource in an editor. The referred resource can be opened quickly by clicking on the link (marked with the icon ) which is displayed before the referred content. The referred resource is resolved through the XML Catalog set in Preferences.

To update the displayed referred content so that it reflects the latest modifications of the referred resource, you can use the Refresh references action. Please note that the content of the expanded external entities can only be refreshed by using the Reload action.