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 many files. XInclude allows you to validate the Master 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 there is 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:


Main book file:


The XInclude support in oXygen is turned on by default. You can turn it off by deselecting Enable XInclude processing from Options / Preferences / XML / XML Parser.

Video Tutorials
" 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