NAME
XML::XSLT v0.22 - A perl module for processing XSLT
SYNOPSIS
use XML::XSLT;
my $parser = XML::XSLT->new ($xslfile, $xslflag, warnings => "Active");
$parser->transform_document ($xmlfile, $xmlflag);
$parser->print_result;
$parser->dispose ();
The variables $xmlfile and $xslfile are filenames, e.g. "filename",
regular Perl filehandles, pass those with *FILEHANDLE, or Perl streams.
After dispose, the parser object is destroyed. The result thus also!
# Alternative sources
The stylesheets and the documents may be passed as filenames, file handles regular strings, string references or DOM-trees. The source type is identified by the flags "FILE" (filename and -handle), "STRING" (string and string ref) and "DOM" (DOM-tree). For example:
my $parser = XML::XSLT->new ($xslstring, "STRING", warnings => "Active");
$parser->transform_document ($xmldom_rootnode, "DOM");
$parser->print_result;
# Alternatives for print_result()
Instead of printing to STDOUT, a filename or file can be passed to print_result():
$parser->print_result($outputfile);
The variable $outputfile is a filename, e.g. "filename" or a regular
Perl filehandle. Pass the latter with *FILEHANDLE.
Instead of printing at all, the result can be requested as a string or a DOM tree as well with:
$parser->result_string;
$parser->result_tree;
# Reusable parser objects
This approach attaches one stylesheet to one parser object. The stylesheet can be applied to multiple documents and multiple parser objects can co-exist:
my $parser1 = XML::XSLT->new ($xslfile1, $xslflag1, warnings => "Active");
my $parser2 = XML::XSLT->new ($xslfile2, $xslflag2, warnings => "Active");
$parser1->transform_document ($xmlfile1, $xmlflag1);
$parser1->print_result ($xmlout1);
$parser1->transform_document ($xmlfile2, $xmlflag2);
$parser1->print_result ($xmlout2);
$parser2->transform_document ($xmlfile1, $xmlflag1);
$parser2->print_result ($xmlout3);
$parser2->transform_document ($xmlfile2, $xmlflag2);
$parser2->print_result ($xmlout4);
This way the stylesheet-file does not have to be parsed all over again, but is reused each time.
DESCRIPTION
This module implements the W3C's XSLT specification. The goal is full implementation of this spec, but it isn't yet. However, it already works well. Below is given the set of working xslt commands.
XML::XSLT makes use of XML::DOM and LWP::UserAgent, while XML::DOM uses XML::Parser. Therefore XML::Parser, XML::DOM and LWP::UserAgent have to be installed properly for XML::XSLT to run.
LICENCE
Copyright (c) 1999 Geert Josten & Egon Willighagen. All Rights Reserverd. This module is free software, and may be distributed under the same terms and conditions as Perl.
XML::XSLT Commands
xsl:apply-imports no
Not supported yet.
xsl:apply-templates limited
Attribute 'select' is supported to the same extent as xsl:value-of supports path selections.
Not supported yet: - attribute 'mode' - xsl:sort and xsl:with-param in content
xsl:attribute partially
Adds an attribute named to the value of the attribute 'name' and as value the stringified content-template.
Not supported yet: - attribute 'namespace'
xsl:attribute-set no
Not supported yet.
xsl:call-template yes
Takes attribute 'name' which selects xsl:template's by name.
Not supported yet: - xsl:sort and xsl:with-param in content
xsl:choose yes
Tests sequentially all xsl:whens until one succeeds or until an xsl:otherwise is found. Limited test support, see xsl:when
xsl:comment yes
Supported.
xsl:copy partially
Not supported yet: - attribute 'use-attribute-sets'
xsl:copy-of limited
Attribute 'select' functions as well as with xsl:value-of
xsl:decimal-format no
Not supported yet.
xsl:element no
Not supported yet.
xsl:fallback no
Not supported yet.
xsl:for-each limited
Attribute 'select' functions as well as with xsl:value-of
Not supported yet: - xsl:sort in content
xsl:if limited
Identical to xsl:when, but outside xsl:choose context.
xsl:import no
Not supported yet.
xsl:include yes
Takes attribute href, which can be relative-local, absolute-local as well as an URL (preceded by identifier http:).
xsl:key no
Not supported yet.
xsl:message no
Not supported yet.
xsl:namespace-alias no
Not supported yet.
xsl:number no
Not supported yet.
xsl:otherwise yes
Supported.
xsl:output no
Not supported yet.
xsl:param experimental
Synonym for xsl:variable (currently). See xsl:variable for support.
xsl:preserve-space no
Not supported yet. Whitespace is always preserved.
xsl:processing-instruction yes
Supported.
xsl:sort no
Not supported yet.
xsl:strip-space no
Not supported yet. No whitespace is stripped.
xsl:stylesheet limited
Minor namespace support: other namespace than 'xsl:' for xsl-commands is allowed if xmlns-attribute is present. xmlns URL is verified. Other attributes are ignored.
xsl:template limited
Attribute 'name' and 'match' are supported to minor extend. ('name' must match exactly and 'match' must match with full path or no path)
Not supported yet: - attributes 'priority' and 'mode'
xsl:text partially
Not supported yet: - attribute 'disable-output-escaping'
xsl:transform limited
Synonym for xsl:stylesheet
xsl:value-of limited
Inserts attribute or element values. Limited support:
<xsl:value-of select="."/>
<xsl:value-of select="/root-elem"/>
<xsl:value-of select="elem"/>
<xsl:value-of select="//elem"/>
<xsl:value-of select="elem[n]"/>
<xsl:value-of select="//elem[n]"/>
<xsl:value-of select="@attr"/>
<xsl:value-of select="text()"/>
<xsl:value-of select="processing-instruction()"/>
<xsl:value-of select="comment()"/>
and combinations of these;
Not supported yet: - attribute 'disable-output-escaping'
xsl:variable experimental
Very limited. It should be possible to define a variable and use it with <xsl:value select="$varname" /> within the same template.
xsl:when limited
Only inside xsl:choose. Limited test support:
<xsl:when test="@attr='value'">
<xsl:when test="elem='value'">
<xsl:when test="path/[@attr='value']">
<xsl:when test="path/[elem='value']">
<xsl:when test="path">
path is supported to the same extend as with xsl:value-of
xsl:with-param experimental
It is currently not functioning. (or is it?)
SUPPORT
Support can be obtained from the XML::XSLT mailling list:
http://xmlxslt.listbot.com/
General information, like bugs and current functionality, can be found at the XML::XSLT homepage:
http://www.sci.kun.nl/sigma/Persoonlijk/egonw/xslt/