XML::Filter::XInclude - XInclude as a SAX Filter
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");
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.
Matt Sergeant, matt@sergeant.org
This is free software, you may use it and distribute it under the same terms as Perl itself.
To install XML::Filter::XInclude, copy and paste the appropriate command in to your terminal.
cpanm
cpanm XML::Filter::XInclude
CPAN shell
perl -MCPAN -e shell install XML::Filter::XInclude
For more information on module installation, please visit the detailed CPAN module installation guide.