Matt Sergeant > XML-Filter-XInclude-1.0 > XML::Filter::XInclude

Download:
XML-Filter-XInclude-1.0.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  2
Open  0
View/Report Bugs
Module Version: 1.0   Source  

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.

syntax highlighting: