|
|
|
|
Simple Lists (Microsoft)
Extension: Simple List
Extensions
Extension Name: cf
Purpose: The Simple List Extension
has two purposes. The primary purpose is to
illustrate that a feed is a list. The secondary
purpose of the list extension is to allow
publishers to mark up the lists to note which
item properties the user may be interested
in sorting or grouping by.
Declaration: The name space for Simple
Lists is defined at http://msdn.microsoft.com/windowsvista/building/rss/simplefeedextensions/
though the specification references the following
url for the definition.
<rss version="2.0" xmlns:cf ="http://www.microsoft.com/schemas/rss/core/2005
">
Elements:
<cf:treatAs> is a sub-element of the
<channel> tag.
<cf:listinfo> is a sub-element of the
<channel> tag and contains <cf:sort>
and <cf:group> tags which define the
sorting and grouping capabilities off the
feed.
The <cf:sort> tag can either specify
a name for the default sort, the order the
items as provided in the feed or it can provide
the information necessary to resot the items
in the feed. To do this it tells the tag name,
the name space the tag is in, what type of
data is in the tag and a name for the sort.
The <cf:group> tag specifys a way to
group the items in a feed. It specifies the
tag, namespace and a label.
Example:
<!-- Snipped for Brevity -->
<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:cf=http://www.microsoft.com/schemas/rss/core/2005"
xmlns:birds="http://www.birds.xml/birdsDTD/"
version="2.0">
<channel>
<title>Bird Watchers Blog</title>
<description>This is a blog of the
birds I have seen. </description>
<link>http://www.mysite.com/birds.htm</link>
<cf:listinfo>
<cf:sort ns="http://www.birds.xml/birdsDTD"
element="wingspan" data-type="number"
label="Wingspan" default="no"/>
<cf group ns="http://www.birds.xml/birdsDTD/"
element="songbird" label="Songbirds"/>
</cf:listinfo>
<item>
<title>The Robin</title>
<link>http://www.mysite.com/birds.htm</link>
<description>The red breasted
Robin</description>
<pubDate> Thu, 15 Dec 2005 12:16:12
-0500</pubDate>
<birds:wingspan>20</birds:wingspan>
<birds:songbird>yes</birds:songbird>
<birds:eggs>4</birds:eggs>
</item>
<item>
<title>The Raven</title>
<link>http://www.mysite.com/birds.htm</link>
<description>The black Raven</description>
<pubDate> Thu, 15 Dec 2005 12:16:12
-0500</pubDate>
<birds:wingspan>120</birds:wingspan>
<birds:songbird>no</birds:songbird>
<birds:eggs>6</birds:eggs>
</item>
<item>
<title>The Scarlet Rosefinch</title>
<link>http://www.mysite.com/birds.htm</link>
<description>The Scarlet Rosefinch</description>
<pubDate> Thu, 15 Dec 2005 12:16:12
-0500</pubDate>
<birds:wingspan>24</birds:wingspan>
<birds:songbird>yes</birds:songbird>
<birds:eggs>5</birds:eggs>
</item>
<!--Snipped for Brevity-->
Example #2:
<!-- Snipped for Brevity -->
<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd"
xmlns:cf="http://www.microsoft.com/schemas/rss/core/2005"
version="2.0">
<channel>
<title>My favorite music</title>
<description>Songs I like</description>
<link>http://www.mysite.com/music.htm</link>
<itunes:owner>
<itunes:email> support@feedforall.com</itunes:email>
<itunes:name>FeedForAll Mac OS Team
</itunes:name>
</itunes:owner>
<cf:listinfo>
<cf:sort ns="http://www.itunes.com/dtds/pdocast-1.0.dtd"
element="explicit" data-type="text"
label="Explicit Songs" default="no"/>
<cf:sort element="category"
data-type="text" label=Song Category"
default="no"/>
</cf:listinfo>
<item>
<title>Twinkle, twinkle little
star </title>
<description>popular childrens
song</description>
<link>http://www.mysite.com/song.htm</link>
<category>Childrens Songs</category>
<enclosure url="http://www.mysite.com/twinkle.mp3"
length="23432" type="audio/mpeg">
</enclosure>
<pubDate> Thu, 15 Dec 2005 12:16:12
-0500</pubDate>
<itunes:subtitle> Twinkle, twinkle
littel star</itunes:subtitle>
<itunes:duration>3.30</itunes:duration>
<itunes:explicit>no</itunes:explicit>
</item>
<item>
<title>Gangsta Killing</title>
<description>rap music</description>
<link>http://www.mysite.com/song.htm</link>
<category>Gangsta Rap</category>
<enclosure url="http://www.mysite.com/gangsta.mp3"
length="43432" type="audio/mpeg">
</enclosure>
<pubDate> Thu, 15 Dec 2005 12:16:12
-0500</pubDate>
<itunes:subtitle> Gangsta Killingr</itunes:subtitle>
<itunes:duration>2.35</itunes:duration>
<itunes:explicit>yes</itunes:explicit>
</item>
<!--Snipped for Brevity-->
|
|
|
|
|
