NAME

HTML::Microformats::Format::hAtom - the hAtom microformat

SYNOPSIS

 use Data::Dumper;
 use HTML::Microformats::DocumentContext;
 use HTML::Microformats::Format::hAtom;

 my $context = HTML::Microformats::DocumentContext->new($dom, $uri);
 my @feeds   = HTML::Microformats::Format::hAtom->extract_all(
                   $dom->documentElement, $context);
 foreach my $feed (@feeds)
 {
   foreach my $entry ($feed->get_entry)
   {
     print $entry->get_link . "\n";
   }
 }

DESCRIPTION

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

Additional Method

  • to_atom

    This method exports the data as an XML file containing an Atom <feed>. It requires XML::Atom::FromOWL to work, and will throw an error at run-time if it's not available.

MICROFORMAT

HTML::Microformats::Format::hAtom supports hAtom as described at http://microformats.org/wiki/hatom, with the following additions:

  • Embedded rel-enclosure microformat

    hAtom entries may use rel-enclosure to specify entry enclosures.

  • Threading support

    An entry may use rel="in-reply-to" to indicate another entry or a document that this entry is considered a reply to.

    An entry may use class="replies hfeed" to provide an hAtom feed of responses to it.

RDF OUTPUT

Data is returned using Henry Story's AtomOWL vocabulary (http://bblfish.net/work/atom-owl/2006-06-06/#), Toby Inkster's AtomOWL extensions (http://buzzword.org.uk/rdf/atomix#) and the IANA registered relationship URIs (http://www.iana.org/assignments/relation/).

BUGS

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

SEE ALSO

HTML::Microformats::Format, HTML::Microformats, HTML::Microformats::Format::hEntry, HTML::Microformats::Format::hNews.

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.