hatom-parsing

From Microformats Wiki
Revision as of 00:44, 31 May 2007 by RyanKing (talk | contribs) (adding reference to hatom#Feed_Category)
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 <id>

@@TBD (not defined by hAtom yet)

Feed <category>

See hAtom: Feed Category

Feed <title>

@@TBD (not defined by hAtom yet)

Feed <updated>

@@TBD (not defined by hAtom yet)

Feed <link>

@@TBD (not defined by hAtom yet)


Extracting entry elements

@@TBD

Entry <link>

Use the first rel-design-pattern 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

  • ...