XInclude Support

XInclude References

XInclude is a standard for building up XML documents from smaller pieces, being a replacement for the external entities. The external entities can be a problem because they cannot have a DOCTYPE declaration, and therefore are not valid documents on their own.

The main use is in the documentation frameworks where the documents may be composed of many files, XInclude allowing the validation of the master file and also the validation of the individual sections.

The advantages of modular documentation are: reusable content units, smaller file units that are edited, better version control, distributed authoring.

XInclude in oXygen

Here is an example of a chapter file and a book file that includes the chapter using XInclude.

Chapter file chapter1.xml:


Main book file:


The XInclude support in oXygen is turned on by default. You can turn it off by using the Options/Preferences/XML/XML Parser Options, the entry Enable XInclude processing.

Video Tutorials
Upcoming Events
oXygen-Users Meetup London 2015
oXygen-Users Meetup
June 5, 2015
London, UK
" oXygen XML Editor is the premier text editor for XML geeks, and an indispensable tool for O'Reilly's Production group. My team uses oXygen XML Editor for everything from simple XML editing to Schema validation and XSLT transformations. The digital production staff especially loves oXygen's built-in EPUB support, which eliminates a great deal of the grunt work that is usually entailed in editing EPUB files. The more we use oXygen, the more realize what a powerful tool it can be in digital and XML-based workflows."
Adam Witwer
Director of Content and Publishing Operations
O'Reilly Media