LibXML Plugin for the Template Toolkit

Version 1.04

11th June 2003

Copyright (C) 2002-3 Mark Fowler. All Rights Reserved

       This is free software; you can redistribute it and/or
           modify it under the same terms as Perl itself.

Hmm, most people will never read this as they'll download with CPANPLUS or CPAN. Here's hoping they click on it from a link from http://search.cpan.org/

STOP: Do you want the main documentation by typing

"perldoc Template::Plugin::XML::LibXML" ?

DESCRIPTION

This is a plugin for XML::LibXML for the template toolkit. It's not that complicated but it does have some interesting features

• Being able to load XML with a USE statement like the XML.XPath plugin does
• VIEW support (erk, this took some explaining)
• Documentation and examples in the main pod that should hopefully mean anyone with an even passing familiarity with XPath should be able to get up and running in minutes

INSTALL

Just like any other Perl module:

tar zxf Template-Plugin-XML-LibXML-X.XX.tar.gz cd Template-Plugin-XML-LibXML-X.XX
perl Makefile.PL
make
make test
make install (as root, or with sudo, etc)

Or, if you're using the new Module::Build install method:

tar zxf Template-Plugin-XML-LibXML-X.XX.tar.gz cd Template-Plugin-XML-LibXML-X.XX
perl Build.PL
./Build
./Build test
./Build install (as root, or with sudo, etc)

This requires

• The Template Toolkit version 2.06 or later
• XML::LibXML 1.52 or later (which itself will require the libxml system library)

It may work with earlier versions of both modules, but it hasn't been tested with them.

It also recommends

• Scalar::Util 1.07

SUPPORT

Support for this module can be requested in three ways:

1. Use the CPAN RT. http://rt.cpan.org/. This is primarly for bugs and feature requests.
2. Use the Template Toolkit mailing list. http://www.template-toolkit.org/mailman/listinfo/templates Best for "should I be using XML.XPath instead" type questions
3. Mailing me directly (mark@twoshortplanks.com)

Problems with the underlying XML::LibXML module probably should be addressed to either the perl xml mailing list at

mailto:perl-xml-request@listserv.ActiveState.com?subject=help

or to the current maintainer of XML::LibXML (Christian Glahn christian.glahn@uibk.ac.at), or to the current maintainers of the underlying GNOME module libxml2.

AUTHOR

This plugin was written by Mark Fowler <mark@twoshortplanks.com>. It uses the XML::LibXML module (written by Matt Sergeant and Christian Glahn) and the Template Toolkit (written by Andy Wardly).

COPYRIGHT

Copyright (C) 2002-3 Mark Fowler. All Rights Reserved.

This is free software; you can redistribute it and/or modify it under the same terms as Perl itself.