Source namespace http://source.smallpict.com/ Tue, 15 Jul 2014 12:42:24 GMT Tue, 15 Jul 2014 12:42:24 GMT en-us Fargo v1.64 http://cyber.law.harvard.edu/rss/rss.html dave.winer@gmail.com davewiner dave.winer.12 The "source" namespace http://source.smallpict.com/2014/07/12/theSourceNamespace.html <p>The <i>source</i> namespace is a collection of add-ons to "RSS 2.0" that provide information about where the content in the feed comes from, so it's possible that aggregators can provide a richer experience for readers. It's the format that "Fargo" generates starting in version 1.64.</p> <p>Example feeds</p> <ul> <li>The <a href="http://scripting.com/rss.xml">feed</a> for my blog, "scripting news", implements some of the features outlined here. </li> <li>Others are implemented in the <a href="http://links.scripting.com/rss.xml">feed</a> for my linkblog.</li> </ul> <p>source:account</p> <ul> <li>A channel-level element.</li> <li>Has one required attribute, service, the name of a service such as "twitter" or "facebook". The value is case insensitive, so Twitter is the same as twitter.</li> <li><code>&lt;source:account service="facebook">dave.winer.12&lt;/source:account></code></li> <li>The value of source:account is the username or screenname of the author of the feed on the indicated service.</li> </ul> <p>source:outline</p> <ul> <li>An item-level element. </li> <li>Exactly the same as the OPML outline element. </li> <li>In RSS, it contains the source of the outline used to render the text of the item.</li> <li>Useful if the aggregator has the ability to render outlines on its own.</li> <li><code>&lt;source:outline text="A silly example" created="Sun, 13 Jul 2014 12:54:20 GMT" type="idea" ></code></li> <li>The example above is very simple and contains no nested structure, which is what makes outlines useful. Check out the Scripting News <a href="http://scripting.com/rss.xml">feed</a> for more extensive examples.</li> </ul> <p>source:archive</p> <ul> <li>A channel-level element.</li> <li>Links to the calendar-structured archive for the feed. </li> <li>The folder pointed to by this address contains one folder for each year, 2009, 2010, 2011, etc.</li> <li>Each of those folders contains one folder for each month, 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12. The month folders must be zero-padded to two places. Folders may be missing, indicating that there is no archived content for the month.</li> <li>Each of the month folders contains folders for the days of the month. Day folder names are also zero-padded to two places and may be missing if there were no updates on the given day. </li> <li>Each day folder contains a file named rss.xml, unless the optional &lt;source:filename> sub-element is supplied, which overrides the default. This makes it possible for a single calendar structure to store the archive of more than one feed. </li> <li>&lt;source:archive> must contain at least two sub-elements: &lt;source:link>, the address of the archive and &lt;source:startDay>, a hyphen-delimited date, formatted as yyyy-mm-dd, for the first element of the archive. </li> <li>It may contain two optional sub-elements: &lt;source:endDay> which is the hyphen-delimited date (yyyy-mm-dd) for the last element in the archive; and &lt;source:filename> as expained above.</li> <li>If &lt;source:endDay> defaults to the pubDate of the feed, if it's specified. If not, it defaults to the current date.</li> <li><code>&lt;source:archive></code></li> <li><code>&lt;source:url>http://static.scripting.com/myReallySimple/&lt;/source:url></code></li> <li><code>&lt;source:filename>linkblog.xml&lt;/source:filename></code></li> <li><code>&lt;source:startDay>2010-12-25&lt;/source:startDay></code></li> <li><code>&lt;source:endDay>2014-07-14&lt;/source:endDay></code></li> <li><code>&lt;/source:archive></code></li> </ul> <p>source:localTime</p> <ul> <li>An item-level element.</li> <li><code>&lt;source:localTime>3/15/2011; 10:34:54 AM&lt;/source:localTime></code></li> <li>A simple entirely human-readable way for the editor of the site to see what time, in his or her time zone, the feed was last updated. Must-have for debugging and sanity-preservation if you have trouble converting GMT to local time in your head (as I do). The format here is entirely up to the editor of the site.</li> </ul> <p>source:linkFull</p> <ul> <li>An item-level element.</li> <li>It's the unshortened version of &lt;link>. </li> <li><code>&lt;source:linkFull>http://nyu.edu/stories/very-long-name/&lt;/source:linkFull></code></li> <li>Only include this elemement when &lt;link> is a shortened url.</li> </ul> Sat, 12 Jul 2014 13:28:17 GMT http://source.smallpict.com/2014/07/12/theSourceNamespace.html