hatom-parsing: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(: Adopted from hcard-parsing)
m (Reverted edits by GetmoNcnaa (Talk) to last version by ScottReynen)
 
(21 intermediate revisions by 3 users not shown)
Line 5: Line 5:


<h2>Editor/Author</h2>
<h2>Editor/Author</h2>
* ...
* [http://theryanking.com/ Ryan King]
 
<h2>Contributors</h2>
* ...
 


= URL handling =
= URL handling =
Line 20: Line 16:


= Finding hAtom feeds/entries =
= Finding hAtom feeds/entries =
@@TBD


* 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 &lt;id&gt; ==
@@TBD (not defined by hAtom yet)
== Feed &lt;title&gt; ==
@@TBD (not defined by hAtom yet)
== Feed &lt;updated&gt; ==
@@TBD (not defined by hAtom yet)
== Feed &lt;link&gt; ==
@@TBD (not defined by hAtom yet)


== Feed &lt;category&gt; ==
See [[hatom#Feed_Category | hAtom: Feed Category]]


= Extracting entry elements =
= Extracting entry elements =
@@TBD
== Entry &lt;link&gt; ==
 
Use the first [[rel-bookmark]] in the entry.
 
== Entry &lt;id&gt; ==
== Entry &lt;id&gt; ==
@@TBD
 
Use the same value as the [[hatom-parsing#Entry_.3Clink.3E | entry link]].
 
== Entry &lt;title&gt; ==
== Entry &lt;title&gt; ==
@@TBD
 
See [[hatom#Entry_Title | hAtom: Entry Title]]
 
== Entry &lt;updated&gt; ==
== Entry &lt;updated&gt; ==
@@TBD
 
See [[hatom#Entry_Updated | hAtom: Entry Updated]]
 
== Entry &lt;published&gt; ==
== Entry &lt;published&gt; ==
@@TBD
== Entry &lt;link&gt; ==
@@TBD


= Parsing datetimes =
See [[hatom#Entry_Published | hAtom: Entry Published]]
@@TBD
 
 
= Extracting tags =
 
See [[rel-tag-parsing]] and [[hatom#Entry_Category | hAtom: Entry Category]].


= Extracting tag links =
See [[hatom#Entry_Category | hAtom: Entry Category]].
@@TBD


= References =
= References =
Line 60: 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 classname hentry, the entire document should be treated as a feed

Extracting feed elements

Feed <category>

See hAtom:

Extracting entry elements

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 <updated>

See hAtom:

Entry <published>

See hAtom:


Extracting tags

See rel-tag-parsing and hAtom:.

See hAtom:.

References

Normative References

Informative References