The Rivendell "superfeed" Namespace

Version 0.1

Fred Gleason

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.

Table of Contents

Overview
Namespace Declaration
Fields
Example

Overview

The "superfeed" XML namespace adds support for additional fields used by Rivendell Superfeed RSS podcasting functionality.

Namespace Declaration

The namespace declaration is:

xmlns:superfeed="http://www.rivendellaudio.org/dtds/superfeed-0.1.dtd"

Fields

The namespace adds the following fields:

<channelTitle>: The value of the <title> field from the <channel> section of the underlying elemental feed.
<channelDescription>: The value of the <description> field from the <channel> section of the underlying elemental feed.

Example

The following example posits the existence of two elemental feeds, AIRPLAY, CARTSLTS and LIBRARY; each containing a single post. A superfeed, called RIVENDEL and consisting of those three elemental fields would look like this:

<?xml version="1.0" encoding="UTF-8"?>

<rss version="2.0" xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:superfeed="http://www.rivendellaudio.org/dtds/superfeed-0.1.dtd">
  <channel>
    <title>Rivendell Radio Automation</title>
    <description>All about the Rivendell Radio Automation System</description>
    <itunes:summary>All about the Rivendell Radio Automation System</itunes:summary>
    <category>Technology</category>
    <link>http://feeds.example.com/rivendel</link>
    <language>en-us</language>
    <copyright>© 2020 John Q. Author</copyright>
    <lastBuildDate>Thu, 4 Jun 2020 12:18:54 GMT</lastBuildDate>
    <pubDate>Thu, 21 May 2020 10:43:55 GMT</pubDate>
    <managingEditor>editor@example.com</managingEditor>
    <webMaster>webmaster@example.com</webMaster>
    <generator>Rivendell 3.3.0int1</generator>
    <image>
      <url>http://feeds.example.com/rivendel/img000022_000038.png</url>
      <title>Rivendell Radio Automation</title>
      <link>http://feeds.example.com/rivendel</link>
      <width>2048</width>
      <height>2048</height>
      <description>The Rivendell Icon</description>
    </image>
    <atom:link href="http://feeds.example.com/rivendel/RIVENDEL.rss" rel="self" type="application/rss+xml" />
    <itunes:author>author@example.com</itunes:author>
    <itunes:type>episodic</itunes:type>
    <itunes:owner>
     <itunes:name>John Q. Author</itunes:name>
      <itunes:email>fredg@paravelsystems.com</itunes:email>
    </itunes:owner>
    <itunes:image href="http://feeds.example.com/rivendel/img000022_000038.png" />
    <itunes:category text="Technology" />
    <itunes:explicit>false</itunes:explicit>
    <item>
      <superfeed:channelTitle>RDAirPlay</superfeed:channelTitle>
      <superfeed:channelDescription>All about RDAirPlay in Rivendell</superfeed:channelDescription>
      <title>Thurber Jewelers</title>
      <itunes:title>Thurber Jewelers</itunes:title>
      <link>http://feeds.example.com/airplay</link>
      <guid isPermaLink="false">http://feeds.example.com/airplay/000019_000026.mp3_000019_000026</guid>
      <description>All about RDAirPlay in Rivendell</description>
      <itunes:summary>All about RDAirPlay in Rivendell</itunes:summary>
      <author>someone@example.com (John Q. Author)</author>
      <itunes:author>someone@example.com (John Q. Author)</itunes:author>
      <comments>http://feeds.example.com/airplay</comments>
      <source url="http://feeds.example.com/airplay/RIVENDEL">Rivendell Radio Automation</source>
      <enclosure url="http://feeds.example.com/airplay/000019_000026.mp3" length="170496" type="audio/mpeg" />
      <category>Technology</category>
      <pubDate>Thu, 21 May 2020 20:31:26 GMT</pubDate>
      <itunes:duration>14</itunes:duration>
      <itunes:image href="http://feeds.example.com/airplay/img000019_000024.png" />
      <itunes:explicit>false</itunes:explicit>
    </item>
    <item>
      <superfeed:channelTitle>RDCartSlots</superfeed:channelTitle>
      <superfeed:channelDescription>All channel all about RDCartSlots!</superfeed:channelDescription>
      <title>Liberty Tax</title>
      <itunes:title>Liberty Tax</itunes:title>
      <link>http://feeds.example.com</link>
      <guid isPermaLink="false">http://feeds.example.com/cartslts/000025_000025.mp3_000025_000025</guid>
      <description>The Liberty tax advisors.</description>
      <itunes:summary>The Liberty tax advisors.</itunes:summary>
      <author>someone@example.com (John Q. Author)</author>
      <itunes:author>someone@example.com (John Q. Author)</itunes:author>
      <comments>http://feeds.example.com/cartslts</comments>
      <source url="http://feeds.example.com/cartslts/RIVENDEL">Rivendell Radio Automation</source>
      <enclosure url="http://feeds.example.com/cartslts/000025_000025.mp3" length="369216" type="audio/mpeg" />
      <category>Technology</category>
      <pubDate>Thu, 21 May 2020 19:17:26 GMT</pubDate>
      <itunes:duration>15</itunes:duration>
      <itunes:image href="http://feeds.example.com/cartslts/img000025_000037.png" />
      <itunes:explicit>false</itunes:explicit>
    </item>
    <item>
      <superfeed:channelTitle>RDLibrary</superfeed:channelTitle>
      <superfeed:channelDescription>A channel all about RDLibrary</superfeed:channelDescription>
      <title>The Peanut Shoppe</title>
      <itunes:title>The Peanut Shoppe</itunes:title>
      <link>http://feeds.example.com/library</link>
      <guid isPermaLink="false">http://feeds.example.com/library/000024_000024.mp3_000024_000024</guid>
      <description>A trip to a peanut and candy shop in downtown Wadsworth OH.</description>
      <itunes:summary>A trip to a peanut and candy shop in downtown Wadsworth OH.</itunes:summary>
      <author>someone@example.com (John Q. Author)</author>
      <itunes:author>someone@example.com (John Q. Author)</itunes:author>
      <comments>http://feeds.example.com/library</comments>
      <source url="http://feeds.example.com/library/RIVENDEL">Rivendell Radio Automation</source>
      <enclosure url="http://feeds.example.com/library/000024_000024.mp3" length="196992" type="audio/mpeg" />
      <category>Technology</category>
      <pubDate>Thu, 21 May 2020 19:14:53 GMT</pubDate>
      <itunes:duration>16</itunes:duration>
      <itunes:image href="http://feeds.example.com/library/img000024_000036.png" />
      <itunes:explicit>false</itunes:explicit>
    </item>
  </channel>
</rss>