XML::GRDDL::Profile(3pm) User Contributed Perl Documentation XML::GRDDL::Profile(3pm)NAME
XML::GRDDL::Profile - represents a profile URI
DESCRIPTION
This module is used internally by XML::GRDDL and you probably don't want to mess with it.
@XML::GRDDL::Profile::ignore is an array of strings and regular expressions for matching profile URIs that should be ignored. You can
fiddle with it, but it voids your warranty.
The ignore list currently consists of the RDFa profile, the GRDDL profile itself, and regular expressions matching profiles that start
'http://purl.org/uF/', 'http://microformats.org/profile/' and 'http://ufs.cc/x/'.
Profile documents many be written in any format supported by RDF::RDFa::Parser or RDF::Trine::Parser, including RDF/XML, Turtle and
XHTML+RDFa.
SEE ALSO
XML::GRDDL.
AUTHOR
Toby Inkster <tobyink@cpan.org>.
COPYRIGHT
Copyright 2008-2011 Toby Inkster
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
perl v5.12.3 2011-02-20 XML::GRDDL::Profile(3pm)
Check Out this Related Man Page
XML::GRDDL(3pm) User Contributed Perl Documentation XML::GRDDL(3pm)NAME
XML::GRDDL - transform XML and XHTML to RDF
SYNOPSIS
High-level interface:
my $grddl = XML::GRDDL->new;
my $model = $grddl->data($xmldoc, $baseuri);
# $model is an RDF::Trine::Model
Low-level interface:
my $grddl = XML::GRDDL->new;
my @transformations = $grddl->discover($xmldoc, $baseuri);
foreach my $t (@transformations)
{
# $t is an XML::GRDDL::Transformation
my ($output, $mediatype) = $t->transform($xmldoc);
# $output is a string of type $mediatype.
}
DESCRIPTION
GRDDL is a W3C Recommendation for extracting RDF data from arbitrary XML and XHTML via a transformation, typically written in XSLT. See
<http://www.w3.org/TR/grddl/> for more details.
This module implements GRDDL in Perl. It offers both a low level interface, allowing you to generate a list of transformations associated
with the document being processed, and thus the ability to selectively run the transformation; and a high-level interface where a single
RDF model is returned representing the union of the RDF graphs generated by applying all available transformations.
Constructor
"XML::GRDDL->new"
The constructor accepts no parameters and returns an XML::GRDDL object.
Methods
"$grddl->discover($xml, $base, %options)"
Processes the document to discover the transformations associated with it. $xml is the raw XML source of the document, or an
XML::LibXML::Document object. ($xml cannot be "tag soup" HTML, though you should be able to use HTML::HTML5::Parser to parse tag soup
into an XML::LibXML::Document.) $base is the base URI for resolving relative references.
Returns a list of XML::GRDDL::Transformation objects.
Options include:
o force_rel - boolean; interpret XHTML rel="transformation" even in the absence of the GRDDL profile.
o strings - boolean; return a list of plain strings instead of blessed objects.
"$grddl->data($xml, $base, %options)"
Processes the document, discovers the transformations associated with it, applies the transformations and merges the results into a
single RDF model. $xml and $base are as per "discover".
Returns an RDF::Trine::Model containing the data. Statement contexts (a.k.a. named graphs / quads) are used to distinguish between data
from the result of each transformation.
Options include:
o force_rel - boolean; interpret XHTML rel="transformation" even in the absence of the GRDDL profile.
o metadata - boolean; include provenance information in the default graph (a.k.a. nil context).
"$grddl->ua( [$ua] )"
Get/set the user agent used for HTTP requests. $ua, if supplied, must be an LWP::UserAgent.
FEATURES
XML::GRDDL supports transformations written in XSLT 1.0, and in RDF-EASE.
XML::GRDDL is a good HTTP citizen: Referer headers are included in requests, and appropriate Accept headers supplied. To be an even better
citizen, I recommend changing the User-Agent header to advertise the name of the application:
$grddl->ua->default_header(user_agent => 'MyApp/1.0 ');
Provenance information for GRDDL transformations is returned using the GRDDL vocabulary at http://www.w3.org/2003/g/data-view#
<http://www.w3.org/2003/g/data-view#>.
Certain XHTML profiles and XML namespaces known not to contain any transformations, or to contain useless transformations are skipped. See
XML::GRDDL::Namespace and XML::GRDDL::Profile for details. In particular profiles for RDFa and many Microformats are skipped, as
RDF::RDFa::Parser and HTML::Microformats will typically yield far superior results.
BUGS
Please report any bugs to <http://rt.cpan.org/>.
Known limitations:
o Recursive GRDDL doesn't work yet.
That is, the profile documents and namespace documents linked to from your primary document cannot themselves rely on GRDDL.
SEE ALSO
XML::GRDDL::Transformation, XML::GRDDL::Namespace, XML::GRDDL::Profile, XML::GRDDL::Transformation::RDF_EASE::Functional,
XML::Saxon::XSLT2.
HTML::HTML5::Parser, RDF::RDFa::Parser, HTML::Microformats.
JSON::GRDDL.
<http://www.w3.org/TR/grddl/>.
<http://www.perlrdf.org/>.
This module is derived from Swignition <http://buzzword.org.uk/swignition/>.
AUTHOR
Toby Inkster <tobyink@cpan.org>.
COPYRIGHT
Copyright 2008-2011 Toby Inkster
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
perl v5.12.3 2011-02-20 XML::GRDDL(3pm)