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.