Author: as
Date: Mon Jan 21 14:59:14 2008
New Revision: 7212
Log:
- Added the contributor ATOM element.
Modified:
trunk/Feed/docs/specifications.txt
Modified: trunk/Feed/docs/specifications.txt
==============================================================================
--- trunk/Feed/docs/specifications.txt [iso-8859-1] (original)
+++ trunk/Feed/docs/specifications.txt [iso-8859-1] Mon Jan 21 14:59:14 2008
@@ -14,47 +14,49 @@
Feed elements
-------------
-+-----------------------+----------------------------+---------------------------+
-| ATOM | RSS1 | RSS2
|
-+=======================+============================+===========================+
-| |ATOM-id|_ ! | |RSS1-about|_ ! | x
|
-+-----------------------+----------------------------+---------------------------+
-| |ATOM-title|_ ! | |RSS1-title|_ ! | |RSS2-title|_ !
|
-+-----------------------+----------------------------+---------------------------+
-| |ATOM-updated|_ ! | x | |RSS2-lastBuildDate|_ ?
|
-+-----------------------+----------------------------+---------------------------+
-| |ATOM-author|_ !* | x | |RSS2-managingEditor|_
? |
-+-----------------------+----------------------------+---------------------------+
-| |ATOM-subtitle|_ ? | |RSS1-description|_ ! | |RSS2-description|_ !
|
-+-----------------------+----------------------------+---------------------------+
-| |ATOM-link|_ !* | |RSS1-link|_ ! | |RSS2-link|_ !
|
-+-----------------------+----------------------------+---------------------------+
-| |ATOM-logo|_ ? | |RSS1-image|_ ? | |RSS2-image|_ ?
|
-+-----------------------+----------------------------+---------------------------+
-| |ATOM-category|_ ?* | x | |RSS2-category|_ ?*
|
-+-----------------------+----------------------------+---------------------------+
-| |ATOM-rights|_ ? | x | |RSS2-copyright|_ ?
|
-+-----------------------+----------------------------+---------------------------+
-| |ATOM-generator|_ ? | x | |RSS2-generator|_ ?
|
-+-----------------------+----------------------------+---------------------------+
-| x | x | |RSS2-ttl|_ ?
|
-+-----------------------+----------------------------+---------------------------+
-| x | x | |RSS2-skipHours|_ ?
|
-+-----------------------+----------------------------+---------------------------+
-| x | x | |RSS2-skipDays|_ ?
|
-+-----------------------+----------------------------+---------------------------+
-| x | x | |RSS2-rating|_ ?
|
-+-----------------------+----------------------------+---------------------------+
-| x | x | |RSS2-cloud|_ ?
|
-+-----------------------+----------------------------+---------------------------+
-| x | x | |RSS2-webMaster|_ ?
|
-+-----------------------+----------------------------+---------------------------+
-| x | |RSS1-textinput|_ ? | |RSS2-textInput|_ ?
|
-+-----------------------+----------------------------+---------------------------+
-| |ATOM-icon|_ ? | x | x
|
-+-----------------------+----------------------------+---------------------------+
-| |ATOM-entry|_ ?* | |RSS1-item|_ !* | |RSS2-item|_ !*
|
-+-----------------------+----------------------------+---------------------------+
++-------------------------+----------------------------+---------------------------+
+| ATOM | RSS1 | RSS2
|
++=========================+============================+===========================+
+| |ATOM-id|_ ! | |RSS1-about|_ ! | x
|
++-------------------------+----------------------------+---------------------------+
+| |ATOM-title|_ ! | |RSS1-title|_ ! | |RSS2-title|_ !
|
++-------------------------+----------------------------+---------------------------+
+| |ATOM-updated|_ ! | x | |RSS2-lastBuildDate|_
? |
++-------------------------+----------------------------+---------------------------+
+| |ATOM-author|_ !* | x |
|RSS2-managingEditor|_ ? |
++-------------------------+----------------------------+---------------------------+
+| |ATOM-subtitle|_ ? | |RSS1-description|_ ! | |RSS2-description|_ !
|
++-------------------------+----------------------------+---------------------------+
+| |ATOM-link|_ !* | |RSS1-link|_ ! | |RSS2-link|_ !
|
++-------------------------+----------------------------+---------------------------+
+| |ATOM-logo|_ ? | |RSS1-image|_ ? | |RSS2-image|_ ?
|
++-------------------------+----------------------------+---------------------------+
+| |ATOM-category|_ ?* | x | |RSS2-category|_ ?*
|
++-------------------------+----------------------------+---------------------------+
+| |ATOM-rights|_ ? | x | |RSS2-copyright|_ ?
|
++-------------------------+----------------------------+---------------------------+
+| |ATOM-generator|_ ? | x | |RSS2-generator|_ ?
|
++-------------------------+----------------------------+---------------------------+
+| x | x | |RSS2-ttl|_ ?
|
++-------------------------+----------------------------+---------------------------+
+| x | x | |RSS2-skipHours|_ ?
|
++-------------------------+----------------------------+---------------------------+
+| x | x | |RSS2-skipDays|_ ?
|
++-------------------------+----------------------------+---------------------------+
+| x | x | |RSS2-rating|_ ?
|
++-------------------------+----------------------------+---------------------------+
+| x | x | |RSS2-cloud|_ ?
|
++-------------------------+----------------------------+---------------------------+
+| x | x | |RSS2-webMaster|_ ?
|
++-------------------------+----------------------------+---------------------------+
+| x | |RSS1-textinput|_ ? | |RSS2-textInput|_ ?
|
++-------------------------+----------------------------+---------------------------+
+| |ATOM-icon|_ ? | x | x
|
++-------------------------+----------------------------+---------------------------+
+| |ATOM-contributor|_ ?* | x | x
|
++-------------------------+----------------------------+---------------------------+
+| |ATOM-entry|_ ?* | |RSS1-item|_ !* | |RSS2-item|_ !*
|
++-------------------------+----------------------------+---------------------------+
| ! = required
| ? = optional
@@ -65,31 +67,33 @@
Item elements
-------------
-+---------------------------+------------------------------+------------------------------+
-| ATOM | RSS1 | RSS2
|
-+===========================+==============================+==============================+
-| |ATOM-entry-id|_ ! | |RSS1-item-about|_ ! | |RSS2-item-guid|_
? |
-+---------------------------+------------------------------+------------------------------+
-| |ATOM-entry-title|_ ! | |RSS1-item-title|_ ! |
|RSS2-item-title|_ ! |
-+---------------------------+------------------------------+------------------------------+
-| |ATOM-entry-updated|_ ! | x | x
|
-+---------------------------+------------------------------+------------------------------+
-| |ATOM-entry-author|_ !* | x |
|RSS2-item-author|_ ? |
-+---------------------------+------------------------------+------------------------------+
-| |ATOM-entry-link|_ !* | |RSS1-item-link|_ ! | |RSS2-item-link|_
! |
-+---------------------------+------------------------------+------------------------------+
-| |ATOM-entry-summary|_ ! | |RSS1-item-description|_ ! |
|RSS2-item-description|_ ! |
-+---------------------------+------------------------------+------------------------------+
-| |ATOM-entry-published|_ ? | x |
|RSS2-item-pubDate|_ ? |
-+---------------------------+------------------------------+------------------------------+
-| |ATOM-entry-category|_ ?* | x |
|RSS2-item-category|_ ?* |
-+---------------------------+------------------------------+------------------------------+
-| |ATOM-entry-rights|_ ? | x | x
|
-+---------------------------+------------------------------+------------------------------+
-| x | x |
|RSS2-item-comments|_ ? |
-+---------------------------+------------------------------+------------------------------+
-| |ATOM-entry-link|_ !* | x |
|RSS2-item-enclosure|_ ? |
-+---------------------------+------------------------------+------------------------------+
++-------------------------------+------------------------------+------------------------------+
+| ATOM | RSS1 | RSS2
|
++===============================+==============================+==============================+
+| |ATOM-entry-id|_ ! | |RSS1-item-about|_ ! |
|RSS2-item-guid|_ ? |
++-------------------------------+------------------------------+------------------------------+
+| |ATOM-entry-title|_ ! | |RSS1-item-title|_ ! |
|RSS2-item-title|_ ! |
++-------------------------------+------------------------------+------------------------------+
+| |ATOM-entry-updated|_ ! | x | x
|
++-------------------------------+------------------------------+------------------------------+
+| |ATOM-entry-author|_ !* | x |
|RSS2-item-author|_ ? |
++-------------------------------+------------------------------+------------------------------+
+| |ATOM-entry-link|_ !* | |RSS1-item-link|_ ! |
|RSS2-item-link|_ ! |
++-------------------------------+------------------------------+------------------------------+
+| |ATOM-entry-summary|_ ! | |RSS1-item-description|_ ! |
|RSS2-item-description|_ ! |
++-------------------------------+------------------------------+------------------------------+
+| |ATOM-entry-published|_ ? | x |
|RSS2-item-pubDate|_ ? |
++-------------------------------+------------------------------+------------------------------+
+| |ATOM-entry-category|_ ?* | x |
|RSS2-item-category|_ ?* |
++-------------------------------+------------------------------+------------------------------+
+| |ATOM-entry-rights|_ ? | x | x
|
++-------------------------------+------------------------------+------------------------------+
+| |ATOM-entry-contributor|_ ?* | x | x
|
++-------------------------------+------------------------------+------------------------------+
+| x | x |
|RSS2-item-comments|_ ? |
++-------------------------------+------------------------------+------------------------------+
+| |ATOM-entry-link|_ !* | x |
|RSS2-item-enclosure|_ ? |
++-------------------------------+------------------------------+------------------------------+
| ! = required
| ? = optional
@@ -195,6 +199,30 @@
Equivalents: `ATOM-category`_, RSS1-none, `RSS2-category`_.
+.. _ATOM-contributor:
+
+ATOM/contributor
+````````````````
+
+One contributor of the feed.
+
+Optional (not recommended).
+
+Multiple contributors can appear.
+
+Required elements: *name*. Optional elements: *uri*, *email*.
+
+Example::
+
+ <contributor>
+ <name>John Doe</name>
+ <uri>http://example.com/~johndoe</uri>
+ <email>[EMAIL PROTECTED]</email>
+ </contributor>
+
+Equivalents: `ATOM-contributor`_, RSS1-none, RSS2-none.
+
+
.. _ATOM-entry:
ATOM/entry
@@ -430,6 +458,30 @@
`RSS2-item-description`_.
+.. _ATOM-entry-contributor:
+
+ATOM/entry/contributor
+``````````````````````
+
+One contributor of the feed entry.
+
+Optional (not recommended).
+
+Multiple contributors can appear.
+
+Required elements: *name*. Optional elements: *uri*, *email*.
+
+Example::
+
+ <contributor>
+ <name>John Doe</name>
+ <uri>http://example.com/~johndoe</uri>
+ <email>[EMAIL PROTECTED]</email>
+ </contributor>
+
+Equivalents: `ATOM-entry-contributor`_, RSS1-none, RSS2-none.
+
+
.. _ATOM-entry-id:
ATOM/entry/id
@@ -1199,6 +1251,7 @@
.. |ATOM-author| replace:: author
.. |ATOM-category| replace:: category
+.. |ATOM-contributor| replace:: contributor
.. |ATOM-entry| replace:: entry
.. |ATOM-generator| replace:: generator
.. |ATOM-icon| replace:: icon
@@ -1213,6 +1266,7 @@
.. |ATOM-entry-author| replace:: author
.. |ATOM-entry-category| replace:: category
.. |ATOM-entry-content| replace:: content
+.. |ATOM-entry-contributor| replace:: contributor
.. |ATOM-entry-id| replace:: id
.. |ATOM-entry-link| replace:: link
.. |ATOM-entry-published| replace:: published
--
svn-components mailing list
svn-components@lists.ez.no
http://lists.ez.no/mailman/listinfo/svn-components
