NAME

XML::Filter::XInclude - XInclude as a SAX Filter

SYNOPSIS

  use XML::SAX;
  use XML::SAX::Writer;
  use XML::Filter::XInclude;

  my $parser = XML::SAX::ParserFactory->parser(
      Handler => XML::Filter::XInclude->new(
          Handler => XML::SAX::Writer->new()
      )
  );
  $parser->parse_uri("foo.xml");

DESCRIPTION

This module implements a simple SAX filter that provides XInclude support. It does NOT support XPointer.

XInclude is very simple, just include something like this in your XML document:

  <xi:include href="foo.xml" 
    xmlns:xi="http://www.w3.org/2001/XInclude"/>

And it will load foo.xml and parse it in the current SAX stream.

If you specify the attribute parse="text", it will be treated as a plain text file, and inserted into the stream as a series of calls to the characters() method.

URI's are supported via LWP.

Currently encoding is not supported.

AUTHOR

Matt Sergeant, matt@sergeant.org

LICENSE

This is free software, you may use it and distribute it under the same terms as Perl itself.