hatom-parsing

From Microformats Wiki
Revision as of 18:15, 1 June 2007 by RyanKing (talk | contribs) (→‎References: adding link to test suite)
Jump to navigation Jump to search

hAtom parsing

Work in progress!

Editor/Author

URL handling

An hAtom parser may begin with a URL to retrieve.

If the URL lacks a fragment identifier, then the parser should parse the entire retrieved resource for hAtom feeds and hAtom entries.

If the URL has a fragment identifier, then the parser should parse only the node indicated by the fragment identifier and its descendants, looking for hAtom feeds and hAtom entries, starting with the indicated node, which may itself be a hAtom feed/entry.

Finding hAtom feeds/entries

  • hAtom feeds are identified with the classname hfeed
  • hAtom entries are identified by the classname hentry
  • if the document does not contain an element with the class name hfeed, but does contain an element with the classname hentry, the entire document should be treated as a feed

Extracting feed elements

Feed <category>

See hAtom: Feed Category

Extracting entry elements

Entry <link>

Use the first rel-bookmark in the entry.

Entry <id>

Use the same value as the entry link.

Entry <title>

See hAtom: Entry Title

Entry <updated>

See hAtom: Entry Updated

Entry <published>

See hAtom: Entry Published


Extracting tag links

See rel-tag-parsing and hAtom: Entry Category.

@@TODO - how this maps to atom

References

Normative References

Informative References