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/.

SEE ALSO

HTML::Microformats::Format, HTML::Microformats, HTML::Microformats::Format::hCard.

AUTHOR

Toby Inkster <tobyink@cpan.org>.

COPYRIGHT AND LICENCE

Copyright 2008-2012 Toby Inkster

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.