<?xml version="1.0" encoding="ISO-8859-1"?>
<!-- OPML generated by Radio UserLand v8.0.5 on Mon, 30 Sep 2002 12:15:03 GMT -->

<opml version="1.1">
	<head>
		<title>rssSpec20.opml</title>
		<dateCreated>Mon, 30 Sep 2002 12:14:02 GMT</dateCreated>
		<dateModified>Mon, 30 Sep 2002 12:15:01 GMT</dateModified>
		<ownerName>Dave Winer</ownerName>
		<ownerEmail>dave@userland.com</ownerEmail>
		<expansionState></expansionState>
		<vertScrollState>1</vertScrollState>
		<windowTop>91</windowTop>
		<windowLeft>472</windowLeft>
		<windowBottom>430</windowBottom>
		<windowRight>1009</windowRight>
		</head>
	<body>
		<outline text="&lt;h4&gt;Contents&lt;/h4&gt;">
			<outline text="&lt;ul&gt;">
				<outline text="&lt;li&gt;&lt;a href=&quot;#whatIsRss&quot;&gt;What is RSS?&lt;/a&gt;"/>
				<outline text="&lt;li&gt;&lt;a href=&quot;#sampleFiles&quot;&gt;Sample files&lt;/a&gt;"/>
				<outline text="&lt;li&gt;&lt;a href=&quot;#aboutThisDocument&quot;&gt;About this document&lt;/a&gt;"/>
				<outline text="&lt;li&gt;&lt;a href=&quot;#requiredChannelElements&quot;&gt;Required channel elements&lt;/a&gt;"/>
				<outline text="&lt;li&gt;&lt;a href=&quot;#optionalChannelElements&quot;&gt;Optional channel elements&lt;/a&gt;"/>
				<outline text="&lt;li&gt;&lt;a href=&quot;#hrelementsOfLtitemgt&quot;&gt;Elements of &lt;item&gt;&lt;/a&gt;"/>
				<outline text="&lt;li&gt;&lt;a href=&quot;#comments&quot;&gt;Comments&lt;/a&gt;"/>
				<outline text="&lt;li&gt;&lt;a href=&quot;#extendingRss&quot;&gt;Extending RSS&lt;/a&gt;"/>
				<outline text="&lt;li&gt;&lt;a href=&quot;#roadmap&quot;&gt;Roadmap&lt;/a&gt;"/>
				<outline text="&lt;li&gt;&lt;a href=&quot;#copyrightAndDisclaimer&quot;&gt;Copyright and disclaimer&lt;/a&gt;"/>
				<outline text="&lt;/ul&gt;"/>
				</outline>
			</outline>
		<outline text="&lt;rules&gt; ">
			<outline text="&lt;rule&gt;&lt;outlineSpacing&gt;1.5&lt;/outlineSpacing&gt;&lt;/rule&gt;"/>
			<outline text="&lt;/rules&gt; "/>
			</outline>
		<outline text="&lt;rules&gt;">
			<outline text="&lt;rule level=&quot;1&quot; to=&quot;1&quot;&gt;">
				<outline text="&lt;textStyle&gt;bold&lt;/textStyle&gt;"/>
				<outline text="&lt;internalLink&gt;&lt;/internalLink&gt;"/>
				<outline text="&lt;/rule&gt; "/>
				</outline>
			<outline text="&lt;/rules&gt;"/>
			</outline>
		<outline text="What is RSS?">
			<outline text="RSS is a Web content syndication format."/>
			<outline text="Its name is an acronym for &lt;i&gt;&lt;b&gt;R&lt;/b&gt;eally &lt;b&gt;S&lt;/b&gt;imple &lt;b&gt;S&lt;/b&gt;yndication.&lt;/i&gt;"/>
			<outline text="RSS is dialect of XML. All RSS files must conform to the XML 1.0 &lt;a href=&quot;http://www.w3.org/TR/REC-xml&quot;&gt;specification&lt;/a&gt;, as published on the World Wide Web Consortium (W3C) website."/>
			<outline text="At the top level, a RSS document is a &amp;lt;rss&gt; element, with a mandatory attribute called version, that specifies the version of RSS that the document conforms to."/>
			<outline text="Subordinate to the &amp;lt;rss&gt; element is a single &amp;lt;channel&gt; element, which contains information about the channel (metadata) and its contents. "/>
			</outline>
		<outline text="Sample files">
			<outline text="Here are sample files for: RSS &lt;a href=&quot;http://static.userland.com/gems/backend/sampleRss.xml&quot;&gt;0.91&lt;/a&gt;, &lt;a href=&quot;http://static.userland.com/gems/backend/gratefulDead.xml&quot;&gt;0.92&lt;/a&gt; and &lt;a href=&quot;http://static.userland.com/gems/backend/rssTwoExample.xml&quot;&gt;2.0&lt;/a&gt;."/>
			<outline text="Note that the sample files may point to documents and services that no longer exist. The 0.91 sample was created when the 0.91 docs were written. Maintaining a trail of samples seems like a good idea."/>
			</outline>
		<outline text="About this document">
			<outline text="&lt;img src=&quot;http://radio.weblogs.com/0001015/images/2002/09/08/flowers.gif&quot; width=&quot;65&quot; height=&quot;85&quot; border=&quot;0&quot; align=&quot;right&quot; hspace=&quot;15&quot; vspace=&quot;5&quot; alt=&quot;A picture of a bouquet of flowers, the symbol of RSS 2.0.&quot;&gt;This document represents the status of RSS as of the Fall of 2002. "/>
			<outline text="It incorporates all changes and additions, starting with the basic spec for &lt;a href=&quot;http://backend.userland.com/rss091&quot;&gt;RSS 0.91&lt;/a&gt; (June 2000) and includes new features introduced in &lt;a href=&quot;http://backend.userland.com/rss092&quot;&gt;RSS 0.92&lt;/a&gt; (December 2000) and RSS 0.94 (August 2002). "/>
			<outline text="Change notes are &lt;a href=&quot;http://backend.userland.com/rssChangeNotes&quot;&gt;here&lt;/a&gt;."/>
			<outline text="First we document the required and optional sub-elements of &lt;channel&gt;; and then document the sub-elements of &lt;item&gt;. The final sections answer frequently asked questions, and provide a roadmap for future evolution, and guidelines for extending RSS."/>
			</outline>
		<outline text="Required channel elements">
			<outline text="Here's a list of the required channel elements, each with a brief description, an example, and where available, a pointer to a more complete description."/>
			<outline text="{includemessage (159, false, false)}"/>
			</outline>
		<outline text="Optional channel elements">
			<outline text="Here's a list of optional channel elements."/>
			<outline text="{includemessage (161, false, false)}"/>
			</outline>
		<outline text="&amp;lt;image&amp;gt; sub-element of &amp;lt;channel&amp;gt;">
			<outline text="&amp;lt;image&gt; is an optional sub-element of &amp;lt;channel&gt;, which contains three required and three optional sub-elements."/>
			<outline text="&amp;lt;url&gt; is the URL of a GIF, JPEG or PNG image that represents the channel. "/>
			<outline text="&amp;lt;title&gt; describes the image, it's used in the ALT attribute of the HTML &amp;lt;img&gt; tag when the channel is rendered in HTML. "/>
			<outline text="&amp;lt;link&gt; is the URL of the site, when the channel is rendered, the image is a link to the site. (Note, in practice the image &amp;lt;title&gt; and &amp;lt;link&gt; should have the same value as the channel's &amp;lt;title&gt; and &amp;lt;link&gt;. "/>
			<outline text="Optional elements include &amp;lt;width&gt; and &amp;lt;height&gt;, numbers, indicating the width and height of the image in pixels. &amp;lt;description&gt; contains text that is included in the TITLE attribute of the link formed around the image in the HTML rendering."/>
			<outline text="Maximum value for width is 144, default value is 88. "/>
			<outline text="Maximum value for height is 400, default value is 31."/>
			</outline>
		<outline text="&amp;lt;cloud&amp;gt; sub-element of &amp;lt;channel&amp;gt;">
			<outline text="&lt;cloud&gt; is an optional sub-element of &lt;channel&gt;. "/>
			<outline text="It specifies a web service that supports the rssCloud interface which can be implemented in HTTP-POST, XML-RPC or SOAP 1.1. "/>
			<outline text="Its purpose is to allow processes to register with a cloud to be notified of updates to the channel, implementing a lightweight publish-subscribe protocol for RSS feeds."/>
			<outline text="&lt;code&gt;&lt;cloud domain=&quot;radio.xmlstoragesystem.com&quot; port=&quot;80&quot; path=&quot;/RPC2&quot; registerProcedure=&quot;xmlStorageSystem.rssPleaseNotify&quot; protocol=\&quot;xml-rpc\&quot; /&gt;&lt;/code&gt;"/>
			<outline text="In this example, to request notification on the channel it appears in, you would send an XML-RPC message to radio.xmlstoragesystem.com on port 80, with a path of /RPC2. The procedure to call is xmlStorageSystem.rssPleaseNotify."/>
			<outline text="A full explanation of this element and the rssCloud interface is &lt;a href=&quot;http://www.thetwowayweb.com/soapmeetsrss#rsscloudInterface&quot;&gt;here&lt;/a&gt;."/>
			</outline>
		<outline text="&amp;lt;ttl&amp;gt; sub-element of &amp;lt;channel&amp;gt;">
			<outline text="&lt;ttl&gt; is an optional sub-element of &lt;channel&gt;. "/>
			<outline text="ttl stands for time to live. It's a number of minutes that indicates how long a channel can be cached before refreshing from the source. This makes it possible for RSS sources to be managed by a file-sharing network such as &lt;a href=&quot;http://www.gnutellanews.com/information/what_is_gnutella.shtml&quot;&gt;Gnutella&lt;/a&gt;. "/>
			<outline text="Example: &lt;ttl&gt;60&lt;/ttl&gt;"/>
			</outline>
		<outline text="&amp;lt;textInput&amp;gt; sub-element of &amp;lt;channel&amp;gt;">
			<outline text="A channel may optionally contain a &amp;lt;textInput&gt; sub-element, which contains four required sub-elements."/>
			<outline text="&amp;lt;title&gt; -- The label of the Submit button in the text input area. "/>
			<outline text="&amp;lt;description&gt; -- Explains the text input area. "/>
			<outline text="&amp;lt;name&gt; -- The name of the text object in the text input area. "/>
			<outline text="&amp;lt;link&gt; -- The URL of the CGI script that processes text input requests. "/>
			<outline text="The purpose of the &lt;textInput&gt; element is something of a mystery. You can use it to specify a search engine box. Or to allow a reader to provide feedback. Most aggregators ignore it."/>
			</outline>
		<outline text="&lt;hr&gt;Elements of &amp;lt;item&amp;gt;">
			<outline text="A channel may contain any number of &amp;lt;item&gt;s. An item may represent a &quot;story&quot; -- much like a story in a newspaper or magazine; if so its description is a synopsis of the story, and the link points to the full story. An item may also be complete in itself, if so, the description contains the text (entity-encoded HTML is allowed), and the link and title may be omitted. All elements of an item are optional, however at least one of title or description must be present."/>
			<outline text="{includemessage (162, false, false)}"/>
			</outline>
		<outline text="&amp;lt;source&amp;gt; sub-element of &amp;lt;item&amp;gt;">
			<outline text="&amp;lt;source&amp;gt; is an optional sub-element of &amp;lt;item&amp;gt;."/>
			<outline text="Its value is the name of the RSS channel that the item came from, derived from its &amp;lt;title&gt;. It has one required attribute, url, which links to the XMLization of the source."/>
			<outline text="&lt;code&gt;&lt;source url=&quot;http://static.userland.com/tomalak/links2.xml&quot;&gt;Tomalak's Realm&lt;/source&gt;&lt;/code&gt;"/>
			<outline text="The purpose of this element is to propogate credit for links, to publicize the sources of news items. It's used in the post command in the Radio UserLand aggregator. It should be generated automatically when forowarding an item from an aggregator to a weblog authoring tool."/>
			</outline>
		<outline text="&amp;lt;enclosure&amp;gt; sub-element of &amp;lt;item&amp;gt;">
			<outline text="&amp;lt;enclosure&amp;gt; is an optional sub-element of &amp;lt;item&amp;gt;."/>
			<outline text="It has three required attributes. url says where the enclosure is located, length says how big it is in bytes, and type says what its type is, a standard MIME type."/>
			<outline text="The url must be an http url."/>
			<outline text="&lt;code&gt;&amp;lt;enclosure url=&quot;http://www.scripting.com/mp3s/weatherReportSuite.mp3&quot; length=&quot;12216320&quot; type=&quot;audio/mpeg&quot; /&amp;gt;&lt;/code&gt;"/>
			<outline text="A use-case narrative for this element is &lt;a href=&quot;http://www.thetwowayweb.com/payloadsforrss&quot;&gt;here&lt;/a&gt;"/>
			</outline>
		<outline text="&amp;lt;category&amp;gt; sub-element of &amp;lt;item&amp;gt;">
			<outline text="&amp;lt;category&amp;gt; is an optional sub-element of &amp;lt;item&amp;gt;."/>
			<outline text="It has one optional attribute, domain, a string that identifies a categorization taxonomy. "/>
			<outline text="The value of the element is a forward-slash-separated string that identifies a hierarchic location in the indicated taxonomy. Processors may establish conventions for the interpretation of categories. Two examples are provided below:"/>
			<outline text="&lt;code&gt;&lt;category&gt;Grateful Dead&lt;/category&gt;&lt;/code&gt;"/>
			<outline text="&lt;code&gt;&lt;category domain=&quot;http://www.fool.com/cusips&quot;&gt;MSFT&lt;/category&gt;&lt;/code&gt;"/>
			<outline text="You may include as many category elements as you need to, for different domains, and to have an item cross-referenced in different parts of the same domain."/>
			</outline>
		<outline text="&amp;lt;pubDate&amp;gt; sub-element of &amp;lt;item&amp;gt;">
			<outline text="&lt;pubDate&gt; is an optional sub-element of &lt;item&gt;."/>
			<outline text="Its value is a &lt;a href=&quot;http://asg.web.cmu.edu/rfc/rfc822.html&quot;&gt;date&lt;/a&gt;, indicating when the item was published. If it's a date in the future, aggregators may choose to not display the item until that date. "/>
			<outline text="&lt;code&gt;&lt;pubDate&gt;Sun, 19 May 2002 15:21:36 GMT&lt;/pubDate&gt;&lt;/code&gt;"/>
			</outline>
		<outline text="&amp;lt;guid&amp;gt; sub-element of &amp;lt;item&amp;gt;">
			<outline text="&lt;guid&gt; is an optional sub-element of &lt;item&gt;."/>
			<outline text="guid stands for globally unique identifier. It's a string that uniquely identifies the item. When present, an aggregator may choose to use this string to determine if an item is new."/>
			<outline text="&lt;code&gt;&lt;guid&gt;http:\//some.server.com/weblogItem3207&lt;/guid&gt;&lt;/code&gt;"/>
			<outline text="There are no rules for the syntax of a guid. Aggregators must view them as a string. It's up to the source of the feed to establish the uniqueness of the string. "/>
			<outline text="If the guid element has an attribute named &quot;isPermaLink&quot; with a value of true, the reader may assume that it is a &lt;a href=&quot;http://www.userland.com/whatIsPermaLink&quot;&gt;permalink&lt;/a&gt; to the item, that is, a url that can be opened in a Web browser, that points to the full item described by the &lt;item&gt; element.  An example:"/>
			<outline text="&lt;code&gt;&lt;guid isPermaLink=&quot;true&quot;&gt;http:\//inessential.com/2002/09/01.php#a2&lt;/guid&gt;&lt;/code&gt;"/>
			<outline text="isPermaLink is optional, its default value is true. If its value is false, the guid may not be assumed to be a url, or a url to anything in particular."/>
			</outline>
		<outline text="&amp;lt;comments&amp;gt; sub-element of &amp;lt;item&amp;gt;">
			<outline text="&lt;comments&gt; is an optional sub-element of &lt;item&gt;."/>
			<outline text="If present, it is the url of the comments page for the item. "/>
			<outline text="&lt;code&gt;&lt;comments&gt;http:\//rateyourmusic.com/yaccs/commentsn/blogId=705245&amp;itemId=271&lt;/comments&gt;&lt;/code&gt;"/>
			</outline>
		<outline text="&amp;lt;author&amp;gt; sub-element of &amp;lt;item&amp;gt;">
			<outline text="&lt;author&gt; is an optional sub-element of &lt;item&gt;."/>
			<outline text="It's the email address of the author of the item. For newspapers and magazines syndicating via RSS, the author is the person who wrote the article that the &lt;item&gt; describes. For collaborative weblogs, the author of the item might be different from the managing editor or webmaster. For a weblog authored by a single individual it would make sense to omit the &lt;author&gt; element."/>
			<outline text="&lt;code&gt;&lt;author&gt;cary\@crophound.net (Cary Dactaraw)&lt;/author&gt;&lt;/code&gt;"/>
			</outline>
		<outline text="Comments">
			<outline text="RSS places restrictions on the first non-whitespace characters of the data in &amp;lt;link&gt; and &amp;lt;url&gt; elements. The data in these elements must begin with http:\// or ftp:\//. Among others, https:, file:, mailto:, news:, and javascript: are not permitted."/>
			<outline text="In RSS 0.91, various elements are restricted to 500 or 100 characters. There can be no more than 15 &lt;items&gt; in a 0.91 &lt;channel&gt;. There are no string-length or XML-level limits in RSS 0.92 and greater. Processors may impose their own limits, and generators may have preferences that say no more than a certain number of &lt;item&gt;s can appear in a channel, or that strings are limited in length."/>
			<outline text="In RSS 2.0, &lt;a name=&quot;syndic8&quot;&gt;a provision&lt;/a&gt; is made for linking a channel to its identifier in a cataloging system, using the channel-level category feature, described above. For example, to link a channel to its Syndic8 identifier, include a category element as a sub-element of &lt;channel&gt;, with domain &quot;Syndic8&quot;, and value the identifier for your channel in the Syndic8 database. The appropriate category element for Scripting News would be &lt;category domain=&quot;Syndic8&quot;&gt;1765&lt;/category&gt;."/>
			<outline text="A frequently asked question about &lt;guid&gt;s is how do they compare to &lt;link&gt;s. Aren't they the same thing? Yes, in some content systems, and no in others. In some systems, &lt;link&gt; is a permalink to a weblog item. However, in other systems, each &lt;item&gt; is a synopsis of a longer article, &lt;link&gt; points to the article, and &lt;guid&gt; is the permalink to the weblog entry. In all cases, it's recommended that you provide the guid, and if possible make it a permalink. This enables aggregators to not repeat items, even if there have been editing changes."/>
			</outline>
		<outline text="Extending RSS">
			<outline text="In 1999, the W3C published a &lt;a href=&quot;http://www.w3.org/TR/REC-xml-names/&quot;&gt;recommendation&lt;/a&gt; for namespaces in XML. "/>
			<outline text="In 2002, with the release of RSS 2.0, we now include the ability to extend RSS, using namespaces."/>
			<outline text="It's very simple. A RSS feed may contain elements not described on this page, only if those elements are defined in a namespace. "/>
			<outline text="For guidance on how to do that, please refer to the W3C document."/>
			</outline>
		<outline text="Roadmap">
			<outline text="RSS is by no means a perfect format, but it is very popular and widely supported. Having a settled spec is something RSS has needed for a long time. The purpose of this work is to help it become a unchanging thing, to foster growth in the market that is developing around it, and to clear the path for innovation in new syndication formats. Therefore, the RSS spec is, for all practical purposes, frozen at version 2.0. We anticipate possible 2.0.1 or 2.0.2 versions, etc. only for the purpose of clarifying the specification, not for adding new features to the format. Subsequent work should happen in modules, using namespaces, and in completely new syndication formats, with new names. "/>
			</outline>
		<outline text="Copyright and disclaimer">
			<outline text="&lt;a name=&quot;copyright&quot;&gt;&amp;copy; Copyright 1997-2002 UserLand Software. All Rights Reserved.&lt;/a&gt;"/>
			<outline text="This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and these paragraphs are included on all such copies and derivative works.  "/>
			<outline text="This document may not be modified in any way, such as by removing the copyright notice or references to UserLand or other organizations. Further, while these copyright restrictions apply to the written RSS specification, no claim of ownership is made by UserLand to the format it describes. Any party may, for commercial or non-commercial purposes, implement this format without royalty or license fee to UserLand. The limited permissions granted herein are perpetual and will not be revoked by UserLand or its successors or assigns."/>
			<outline text="This document and the information contained herein is provided on an &quot;AS IS&quot; basis and USERLAND DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE."/>
			</outline>
		</body>
	</opml>
