hatom-parsing: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
m (parsing datetimes)
m (Reverted edits by GetmoNcnaa (Talk) to last version by ScottReynen)
 
(22 intermediate revisions by 4 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 =
* ...


An hAtom parser may begin with a URL to retrieve.


= URL handling =
If the URL lacks a fragment identifier, then the parser should parse the entire retrieved resource for hAtom feeds and hAtom entries.
@@TBD
 
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 =
@@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 55: 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: 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 tags

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

See hAtom: Entry Category.

References

Normative References

Informative References