XInclude Support

XInclude References

XInclude is a standard for building XML documents from smaller pieces and is an alternative to the use of external entities. The use of external entities can pose a problem because they cannot have a DOCTYPE declaration, and therefore are not valid documents on their own.

XInclude is mainly used in documentation frameworks where the documents may be composed of numerous files. XInclude allows you to validate the Main File as well as individual sections.

The advantages of modular documentation include reusable content units, smaller file units to be edited, better version control, and distributed authoring.

XInclude in Oxygen

In the following images, you see an example of a chapter file named chapter1.xml and a book file that uses XInclude to reference the chapter file.

Chapter file chapter1.xml:

XInclude

Main book file:

XInclude

What's New in
Oxygen XML Author 27.1

March 24, 2025

Oxygen XML Author version 27.1 simplifies content creation and management with AI-driven capabilities to fix validation issues and to generate MathML. A refined DITA publishing framework with DITA-OT 4.3.0 is integrated, and the updated Git Client add-on supports efficient branching and merging.

Learn more

What's New in
Oxygen XML Web Author 27.1.0

March 24, 2025

Oxygen XML Web Author version 27.1.0 refines its web-based collaboration tools with a new Differences view in the File Comparison interface, extended AI features for validation fixes and local file attachments, simplified DITA map management, and more.

Learn more