Syndication/formats/feedheader
From Steeple
< Syndication | formats
Syndication: Introduction | Formats | metafeed | feedheader | short item | long item | examples | spec | Print / Index
The metafeed refers to a number of feeds. These can be other metafeeds, or they can be content feeds (i.e. normal rss feeds).
Here we give an example of a content feed, with relatively complete data. For brevity, we only do this in RSS2.0, but the equivalence with atom should be clear from the metafeed example.
<?xml version="1.0" encoding="utf-8"?> <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:s="http://purl.org/steeple" xmlns:media="http://video.search.yahoo.com/mrss/" xmlns:cc="http://backend.userland.com/creativeCommonsRssModule" xmlns:georss="http://www.georss.org/georss" xmlns:gml="http://www.opengis.net/gml" xmlns:ev="http://purl.org/rss/1.0/modules/event/" xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#" > <title>A podcast from the Physics Department at the University of Oxford</title> <atom:link rel="self" href=".../this_feed.xml" /> <atom:link rel="alternate" href=".../some_page.html" /> <!-- <guid isPermaLink="false">urn:uuid:...</guid> Use the same as we do for item. --> <atom:id>ox.ac.uk/...</atom:id> <lastBuildDate>2009-09-13T23:55:18Z</lastBuildDate> <!-- <atom:updated>2009-09-13T23:55:18Z</atom:updated> <author> is ignored. --> <description>This is the podcast of the physics departement from Oxford University</description> <!-- Preference for categorisation to be in the feed header. The most specific use of the element counts, so item overrides feed header. --> <atom:category scheme="http://purl.org/steeple/organisation" term="http://www.ox.ac.uk" label="Oxford University" /> <atom:category scheme="http://purl.org/steeple/division" term="physicalsciences" label="Section of Physical Sciences" /> <atom:category scheme="http://purl.org/steeple/department" term="physics" label="Physics Department" /> <atom:category scheme="http://purl.org/steeple/group" term="Something research group" /> <atom:category scheme="http://purl.org/steeple/feedtype" term="media" /> <media:thumbnail url=".../physics.jpg" width="75" height="50" /> <!-- Does this feed represent a course? Normally this would be done at feed level, but it can be added at item-level if the rss feed describes several courses (or the rss is the result of a search). To indicate what this feed/item is, we provide a category. If the feed represents a course, we add term="course" which uses <media:title s:type="course"> / description as course title, or, if not present, uses title / description from the feed. NOTE: The course/playlist/series/collection is relative to the finest grain organisation/division/department. I.e. if just organisation is specified above, the course is releative to the organisation (i.e. organisation-wide). If an organisation/department/group is specified, a course/series/collection/playlist is a playlist specific to that group. (Need to see whether this is too restrictive in the long term.) These items are based on ARCA. <source lang="xml"> --> <media:category scheme="http://purl.org/steeple/feedtype" >course</media:category> <!-- Possible terms: course, series, collection, playlist Series / course. A course is a series of lectures that follows a definite syllabus, and would typically have the same lecturer throughout. A series is a loose collection, that relates to a series of events (such as a distinguished lecture series), or is regular podcast. A non-specified grouping is a collection (that doesn't imply any particular order). If an order is implied, playlist can be used. Title: The title at feed level can be omitted, because the feed title can be used. If the course is specified at item level, a title needs to be present. --> <media:title s:type="series">An item in our demo series</media:title> <media:title s:type="course">The title</media:title> <media:title s:type="collection" s:href="...">The title</media:title> <media:title s:type="playlist" s:href="...">The title</media:title> <!-- A specific description and images can be added. Again, at feed level, the other descrpition/images can be used. At item level, they need to be present. --> <media:description s:type="course">Además del calentamiento global, el cambio climático implica cambios en otras variables como las lluvias globales.</media:description> <media:image s:type="courseimage">http://foo.es/images/thumbs/clima.jpg</media:image> <media:image s:type="coursebanner">http://foo.es/images/banner_clima.jpg</media:image> <!-- A link for series/course/collection/playlist can be provided. --> <atom:link rel="http://purl.org/steeple/courselink" href="..." /> <!-- If an item is part of several groups (each of which have just a title), use --> <media:title s:type="playlist" s:href="...">An item in our demo series</media:title> <media:title s:type="playlist" s:href="...">An item in our other demo series</media:title> <!-- If these items all have descriptions, use <media:group> to group them. Alternative: <media:category domain="http://purl.org/steeple/cscp/course" label="my course title">the term of this course, e.g. course identifier</media:category> --> <!-- We could assume that the feed is specifically created so that all items can be syndicated to a common portal. However, owners of certain feeds (or even items within feeds) may wish to opt out (or in) to syndication to various sites. If this is set at individual item level, it may be impractical to rewrite the feeds to only include syndicated items. Hence we add a facility to add a list of sites to which syndication is permitted. These can appear at item or feed level. --> <atom:category scheme="http://purl.org/steeple/syndication/allow" term="iTunesU.com/Cambridge" /> <atom:category scheme="http://purl.org/steeple/syndication/allow" term="YouTube/Edu/Cambridge" /> <atom:category scheme="http://purl.org/steeple/syndication/allow" term="opencontent.org.uk" /> <atom:category scheme="http://purl.org/steeple/syndication/allow" term="steeple.org.uk" /> <!-- Similarly, a list of sites to which syndication is denied. --> <atom:category scheme="http://purl.org/steeple/syndication/deny" term="some.other.sharing.site" /> </rss>
Page imported from here.
