NAME

HTML::Microformats::Format::hReview - the hReview and xFolk microformats

SYNOPSIS

use HTML::Microformats::DocumentContext;
use HTML::Microformats::Format::hReview;

my $context = HTML::Microformats::DocumentContext->new($dom, $uri);
my @reviews = HTML::Microformats::Format::hReview->extract_all(
                  $dom->documentElement, $context);
foreach my $review (@reviews)
{
  print $review->get_reviewer->get_fn . "\n";
}

DESCRIPTION

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

MICROFORMAT

HTML::Microformats::Format::hReview supports hReview 0.3 and xFolk as described at http://microformats.org/wiki/hreview and http://microformats.org/wiki/xfolk, with the following differences:

  • hAudio

    hAudio microformats can be used as the reviewed item.

    (At the time of writing this documentation however, HTML::Microformats didn't support hAudio!)

  • Jumbled-up

    Support for xFolk and hReview are bundled together, so properties are usually supported in both, even if only defined by one microformat spec. (e.g. reviewer is defined by hReview, but this module supports it in xFolk entries.)

RDF OUTPUT

http://www.purl.org/stuff/rev#, http://ontologi.es/hreview#.

BUGS

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

Known limitations:

  • If no "reviewer" is found inside the hReview, parsers should look outside the hReview, in the context of the page, for the "reviewer". If there is no "reviewer" outside either, then parsers should use the author defined by the containing document language, e.g. for HTML documents, the <address> contact info for the page (which is ideally marked up as an hCard as well).

SEE ALSO

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

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.