NAME

HTML::Microformats::Format::XFN - the XFN microformat

SYNOPSIS

 use Data::Dumper;
 use HTML::Microformats::DocumentContext;
 use HTML::Microformats::Format::XFN;
 my $context = HTML::Microformats::DocumentContext->new($dom, $uri);
 my @links   = HTML::Microformats::Format::XFN->extract_all(
                   $dom->documentElement, $context);
 foreach my $link (@links)
 {
   printf("<%s> %s\n", $link->get_href, join(" ", $link->get_rel));
 }

DESCRIPTION

HTML::Microformats::Format::XFN inherits from HTML::Microformats::Format. See the base class definition for a description of property getter/setter methods, constructors, etc.

Additional Public Methods

"$xfn->subject_hcard": Returns the hCard for the subject of the relationship. e.g. if Mary has parent Sue, then Mary is the subject.
If the subject could not be determined, may return undef.
"$xfn->object_hcard": Returns the hCard for the object of the relationship. e.g. if Mary has parent Sue, then Sue is the object.
The person that is the object of the relationship may not have an hCard on this page, or the parser may not be able to determine the correct hCard, in which case, may return undef.

MICROFORMAT

HTML::Microformats::Format::XFN supports XHTML Friends Network 1.0 and 1.1 as described at <http://gmpg.org/xfn/1> and <http://gmpg.org/xfn/11>; plus the relationship profile described at <http://purl.org/vocab/relationship/>; and XHTML Enemies Network 1.0 as described at <http://xen.adactio.com/>.

By default, only XFN 1.1 is parsed, but if the context has profiles matching the other URIs above, then the other vocabularies are supported.

RDF OUTPUT

Data is returned using the DERI's XFN vocabulary (<http://vocab.sindice.com/xfn#>) and when appropriate, Ian Davis' RDF relationship vocab (<http://purl.org/vocab/relationship/>) and Toby Inkster's XEN vocab (<http://buzzword.org.uk/rdf/xen#>).

BUGS

Please report any bugs to <http://rt.cpan.org/>.

AUTHOR

Toby Inkster <tobyink@cpan.org>.

COPYRIGHT AND LICENCE

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

DISCLAIMER OF WARRANTIES

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.