hatom-parsing: Difference between revisions
Jump to navigation
Jump to search
(skeleton) |
m (Reverted edits by GetmoNcnaa (Talk) to last version by ScottReynen) |
||
| (23 intermediate revisions by 4 users not shown) | |||
| Line 5: | Line 5: | ||
<h2>Editor/Author</h2> | <h2>Editor/Author</h2> | ||
* . | * [http://theryanking.com/ Ryan King] | ||
= 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 = | = Finding hAtom feeds/entries = | ||
* hAtom feeds are identified with the classname <code>hfeed</code> | |||
* hAtom entries are identified by the classname <code>hentry</code> | |||
* if the document does not contain an element with the class name <code>hfeed</code>, but does contain an element with the classname <code>hentry</code>, the entire document should be treated as a feed | |||
= Extracting feed elements = | = Extracting feed elements = | ||
== Feed <category> == | |||
See [[hatom#Feed_Category | hAtom: Feed Category]] | |||
= Extracting entry elements = | = Extracting entry elements = | ||
== Entry <link> == | |||
Use the first [[rel-bookmark]] in the entry. | |||
== Entry <id> == | == Entry <id> == | ||
Use the same value as the [[hatom-parsing#Entry_.3Clink.3E | entry link]]. | |||
== Entry <title> == | == Entry <title> == | ||
See [[hatom#Entry_Title | hAtom: Entry Title]] | |||
== Entry <updated> == | == Entry <updated> == | ||
See [[hatom#Entry_Updated | hAtom: Entry Updated]] | |||
== Entry <published> == | == Entry <published> == | ||
= Extracting tag | See [[hatom#Entry_Published | hAtom: Entry Published]] | ||
= Extracting tags = | |||
See [[rel-tag-parsing]] and [[hatom#Entry_Category | hAtom: Entry Category]]. | |||
See [[hatom#Entry_Category | hAtom: Entry Category]]. | |||
= References = | = References = | ||
| Line 52: | Line 62: | ||
== Informative References == | == Informative References == | ||
* ... | * [http://hg.microformats.org/tests test suite] - work in progress! | ||
* [http://microformats.org/wiki/parsing parsing] - general microformat parsing | |||
Latest revision as of 19:21, 10 December 2008
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 classnamehentry, the entire document should be treated as a feed
Extracting feed elements
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>
Entry <updated>
Entry <published>
Extracting tags
See rel-tag-parsing and hAtom: Entry Category.
References
Normative References
Informative References
- test suite - work in progress!
- parsing - general microformat parsing