NAME

XML::GXML - Perl extension for XML transformation, XML->HTML conversion

SYNOPSIS

use XML::GXML;

my $gxml = new XML::GXML();

# Take a scalar, return a scalar
my $xml = '<basetag>hi there</basetag>';
my $new = $gxml->Process($xml);

# Take a file, return a scalar
print $gxml->ProcessFile('source.xml');

# Take a file, output to another file
$gxml->ProcessFile('source.xml', 'dest.xml');

DESCRIPTION

GXML is a perl module for transforming XML. It may be put to a variety of tasks; in scope it is similar to XSL, but less ambitious and much easier to use. In addition to XML transformations, GXML is well-suited to translating XML into HTML. Please see the documentation with your distribution of GXML, or visit its web site at:

http://multipart-mixed.com/xml/

SUMMARY OF PARAMETERS

These are the options for creating a new GXML object. All options are passed in via a hash reference, as such:

# Turn on HTML mode and provide callbacks hash
my $gxml = new XML::GXML({'html'      => 'on', 
                          'callbacks' => \%callbacks});

Here's the complete list of options. Keys are provided first, with their values following:

html:           'on' or 1 will format output as HTML (see docs).
templateDir:    directory to look for templates.
remappings:     hashref mapping tag names to remap to their remapped
                names.
dashConvert:    'on' or 1 will convert '--' to unicode dash.
addlAttrs:      reference to subroutine that gets called on lookup
                for dynamic attributes.
addlTemplates:  hashref mapping from dynamic template name to
                subroutine that will create that template. (Use this
                instead of the following 2 params.)
addlTempExists: (outdated -- use addlTemplates instead.)
addlTemplate:   (outdated -- use addlTemplates instead.)

AUTHOR

Josh Carter, josh@multipart-mixed.com

SEE ALSO

perl(1).