SEARCH
TOOLBOX
LANGUAGES
Create a book
Syndication/formats/for the impatient

Syndication/formats/for the impatient

From Steeple

Jump to: navigation, search

[edit] 1 A super quick overview!

[edit] 1.1 How do you make a feed of feeds?

I assume you're familiar with either rss or atom already! The full specifications are here Syndication/formats/metafeed, but basically making an 'index feed' (a feed of feeds) boils down to having a standard rss feed, with one entry per sub-feed. In the index feed, you'll need these namespaces:

 xmlns:atom="http://www.w3.org/2005/Atom"
 xmlns:s="http://purl.org/steeple"
 xmlns:media="http://video.search.yahoo.com/mrss/"

These items in the index feed should link to the sub-feeds like this:

 <atom:link type="application/rss+xml" 
       href="http://www...../myfeed.xml" 
       rel="http://purl.org/steeple/subfeed" />

Other than this, this 'index' feed should have this in the header:

 <atom:category scheme="http://purl.org/steeple/organisation" 
                         term="your organisation url" 
                         label="your organisation name" />
 <atom:category scheme="http://purl.org/steeple/feedtype"  
                         term="root" />

and (ideally) an image for the header and each item:

 <media:thumbnail url="..." width="..." height="...." />

(Atom or rss will do!)

[edit] 1.2 How do you make media feeds?

The other feeds ('media feeds'), i.e. the feeds to which the root feed links, should have some extra elements:

Channel:

 <atom:category scheme="http://purl.org/steeple/organisation" 
                         term="your organisation url" 
                         label="your organisation name" />
 <media:credit role="publisher" scheme="http://purl.org/steeple/credit">your organisation name</media:credit>
 <atom:category scheme="http://purl.org/steeple/feedtype"  term="media" />

If the media type is uniform you can use this in the channel

 <atom:category scheme="http://purl.org/steeple/mediatype" term="video|audio|screencast" />

otherwise you can use it in the item.

Same as the root feed, each feed header + each item therein should have an image

 <media:thumbnail url="..." width="..." height="...." />

It would be neat (but is by no means required), if each item (in media feeds) had this:

 <s:duration>5:31</s:duration>
 <media:keywords>a, b, c</media:keywords>

That's it!