Please refer to the errata for this document, which may include some normative corrections.
See also translations.
This document is also available in these non-normative formats: XML and XHTML with color-coded revision indicators.
Copyright © 2006 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark and document use rules apply.
This document specifies a processing model and syntax for general purpose inclusion. Inclusion is accomplished by merging a number of XML information sets into a single composite infoset. Specification of the XML documents (infosets) to be merged and control over the merging process is expressed in XML-friendly syntax (elements, attributes, URI references).
This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at http://www.w3.org/TR/.
This document has been produced by the W3C XML Core Working Group as part of the XML Activity. The English version of this specification is the only normative version. However, for translations of this document, see http://www.w3.org/2003/03/Translations/byTechnology?technology=xinclude10.
This document is a W3C Recommendation. This second edition is not a new version of XInclude. As a convenience to readers, it incorporates the changes dictated by the accumulated errata (available at http://www.w3.org/2004/12/xinclude-errata/ to the First Edition of XInclude 1.0, dated 20 December 2004, which it supersedes.
Please report errors in this document to the public www-xml-xinclude-comments@w3.org mailing-list; archives are available. The errata list for this edition is available at http://www.w3.org/XML/2006/11/xinclude-errata/.
Known implementations are documented in the XInclude Implementation Report at http://www.w3.org/XML/2004/xinclude-implementation/report.html. A Test Suite is maintained at http://www.w3.org/XML/Test/XInclude/ to help in assessing conformance to this specification. The latest release of the Test Suite includes new test cases which implementers can use to check their conformance to the changes included in this new edition.
This document has been reviewed by W3C Members, by software developers, and by other W3C groups and interested parties, and is endorsed by the Director as a W3C Recommendation. It is a stable document and may be used as reference material or cited from another document. W3C's role in making the Recommendation is to draw attention to the specification and to promote its widespread deployment. This enhances the functionality and interoperability of the Web.
This document is governed by the 24 January 2002 CPP as amended by the W3C Patent Policy Transition Procedure. W3C maintains a public list of any patent disclosures made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy.
1 Introduction
1.1 Relationship to XLink
1.2 Relationship to XML External Entities
1.3 Relationship to DTDs
1.4 Relationship to XML Schemas
1.5 Relationship to Grammar-Specific Inclusions
2 Terminology
3 Syntax
3.1 xi:include Element
3.2 xi:fallback Element
4 Processing Model
4.1 The Include Location
4.1.1 Escaping of href attribute values
4.1.2 Using XInclude with Content Negotiation
4.2 Included Items when parse="xml"
4.2.1 Document Information Items
4.2.2 Multiple Nodes
4.2.3 Range Locations
4.2.4 Point Locations
4.2.5 Element, Comment, and Processing Instruction Information Items
4.2.6 Attribute and Namespace Declaration Information Items
4.2.7 Inclusion Loops
4.3 Included Items when parse="text"
4.4 Fallback Behavior
4.5 Creating the Result Infoset
4.5.1 Unparsed Entities
4.5.2 Notations
4.5.3
references Property Fixup
4.5.4 Namespace Fixup
4.5.5 Base URI Fixup
4.5.6 Language Fixup
4.5.7 Properties Preserved by the Infoset
5 Conformance
5.1 Markup Conformance
5.2 Application Conformance
5.3 XML Information Set Conformance
A References
B References (Non-Normative)
C Examples (Non-Normative)
C.1 Basic Inclusion Example
C.2 Textual Inclusion Example
C.3 Textual Inclusion of XML Example
C.4 Fragment Inclusion Example
C.5 Range Inclusion Example
C.6 Fallback Example