E.18 XincludeFilter
Prev | Appendix E. Core filters | Next

## E.18 XincludeFilter

The `XincludeFilter` processes a stream for Xinclude tags, and processes the inclusions. This is useful for processing modular XML files. DocBook book files are one example of modular XML files. Usage example:

    <!--
      Render a DocBook book file called manual.xml, which
      contains Xinclude tags to include individual book sections.
      -->
    <copy todir="${manual.dest.dir}">
      <filterchain>
        <xincludefilter basedir="${manual.src.dir}" />
        <xsltfilter style="${manual.src.dir}/html.xsl">
          <param name="base.dir" expression="${manual.dest.dir}/" />
        </xsltfilter>
      </filterchain>
      <fileset dir="${manual.src.dir}">
        <include name="manual.xml" />
      </fileset>
    </copy>

Table E.12: Attributes for the `<xincludefilter>` tag

Name | Type | Description | Default | Required
--- | --- | --- | --- | ---
`basedir` | `String` | The working directory from which to process the `Xincludes`. Relative pathnames in the include tags are based on this location. | Project basedir | No
`resolveexternals` | `Boolean` | Whether to resolve entities. (see this link for details) | `false` | No

Prev | Up | Next
E.17 TidyFilter | Home | E.19 XsltFilter