oracular (3) HTML::Microformats::Format::XFN.3pm.gz

Provided by: libhtml-microformats-perl_0.105-6_all bug

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