# The Rivendell "superfeed" Namespace

Version 0.1
v0.1
Fred
Gleason
fredg@paravelsystems.com
v0.1
2020
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.

## 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>