hatom-parsing

(Difference between revisions)

Jump to: navigation, search
m (parsing datetimes)
Current revision (19:21, 10 December 2008) (view source)
m (Reverted edits by GetmoNcnaa (Talk) to last version by ScottReynen)
 
(22 intermediate revisions 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

Current revision

hAtom parsing

Work in progress!

Contents


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

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

hatom-parsing was last modified: Wednesday, December 10th, 2008

Views