NAME

XML::Feed::Format::hAtom - plugin to provide transparent parsing and generation support for hAtom to XML::Feed

SYNOPSIS

    use XML::Feed;
    my $feed = XML::Feed->parse(URI->new('http://example.com/hatom.html'))
        or die XML::Feed->errstr;
    print $feed->title, "\n";
    for my $entry ($feed->entries) {
    }

DESCRIPTION

XML::Feed is a syndication feed parser for both RSS and Atom feeds. It also implements feed auto-discovery for finding feeds, given a URI.

XML::Feed::Format::hAtom adds transparent support for the hAtom microformat.

        http://microformats.org/wiki/hatom      

METHODS

See XML::Feed and XML::Feed::Entry - hAtom support is transparent.

XML::Feed::Format::hAtom->identify <content>

Whether or not this in hAtom feed.

XML::Feed::Format::hAtom->init_string <content>

Initialise a new Feed from a string.

Alias for parse.

$feed->id

Returns the id of the feed.

$feed->format

Returns the format of the feed (hAtom).

$feed->title([ $title ])

The title of the feed/channel.

$feed->base([ $base ])

The url base of the feed/channel.

$feed->link([ $uri ])

The permalink of the feed/channel.

$feed->tagline([ $tagline ])

The description or tagline of the feed/channel.

$feed->description([ $description ])

Alias for $feed->tagline.

$feed->author([ $author ])

The author of the feed/channel.

$feed->language([ $language ])

The language of the feed.

$feed->copyright([ $copyright ])

The copyright notice of the feed.

$feed->modified([ $modified ])

A DateTime object representing the last-modified date of the feed.

If present, $modified should be a DateTime object.

$feed->updated([ $updated ])

Alias for modified.

$feed->generator([ $generator ])

The generator of the feed.

$feed->category ([ $category ])

The category for this feed.

$feed->self_link ([ $uri ])

The Atom Self-link of the feed:

http://validator.w3.org/feed/docs/warning/MissingAtomSelfLink.html

A string.

$feed->long ([ $lat ])

$feed->lat ([ $lat ])

The longitude and latitude of the entry if available.

$feed->entries

A list of the entries/items in the feed. Returns an array containing XML::Feed::Entry objects.

$feed->items

A synonym for $feed-entries>.

$feed->add_entry($entry)

Adds an entry to the feed. $entry should be an XML::Feed::Entry object in the correct format for the feed.

$feed->as_xml

Returns an HTML representation of the feed, in the format determined by the current format of the $feed object.

LICENSE

XML::Feed::Format::hAtom is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR & COPYRIGHT

Written by Simon Wistow <swistow@sixapart.com>

Except where otherwise noted, XML::Feed::Format::hAtom is Copyright 2008 Six Apart, cpan@sixapart.com. All rights reserved.

SUBVERSION

The latest version of XML::Feed::Format::hAtom can be found at

    http://code.sixapart.com/svn/XML-Feed-Format-hAtom/trunk/

cpanm XML::Feed::Entry::Format::hAtom

perl -MCPAN -e shell
install XML::Feed::Entry::Format::hAtom