RSS 2.0 specification [translate]

rss| specification

Original address: Http://blogs.law.harvard.edu/tech/rss

what is RSS?

RSS is a syndication format for Web content sydication format.

Its name is the abbreviation of Really Simple syndication.

RSS is one of the XML. All RSS documents follow the XML 1.0 specification, which is posted on the Web site.

At the beginning of an RSS document is a <rss> node and a specified property version, which sets the document to be expressed in which versions of RSS. If the document is represented by this specification, its version attribute must be equal to 2.0.

The next level of the <rss> node is a separate <channel> node that contains information and content about channel.

About this document

The document was written in the fall of 2002, when the RSS version was 2.0.1.

It contains all the modifications and additions that began with the RSS 0.91 Specification (2000), as well as new features included in RSS 0.92 (December 2000) and RSS 0.94 (August 2002).

Required Channel node

Here is a list of the channel (channel) nodes that must be included, each with a simple description,

An example, a location that should appear, and a more detailed description of the hyperlink.
Element Description Example
Title channel (channel) name. It can tell others how to access your service. If you have a RSS file with your

Content consistent with the HTML site, your Title element value should be the same as the title of your site.

goupstate.com News Headings
Link responds to the URL of the channel's web site http://www.goupstate.com/
Description about the channel description of the latest news from Goupstate.com,

A Spartanburg herald-joural Web Site

Optional channel elements

The following is an optional list of channel elements
Element Description Example
Language used by language. This allows the aggregator to group all Italian-language sites. En-US
Copyright 2002, Spartanburg Herald-journal
Managingeditor email geo@herald.com The content owner (George Matesky)
Webmaster Technician's Email betty@herald.com (Betty Guernsey)
pubdate content Release time Sat, modified SEP 2002 00:00:01 GMT
Lastbuilddate Last update Time Sat, SEP 2002 09:42:31 GMT
Category specifies one or more categories to which the channel belongs. Follow the same rules as the item-level category element. <category>Newspapers</category>
Generator The program name that generated the channel Mightyinhouse Content System v2.3
Docs point to the URL of the RSS format document? Http://blogs.law.harvard.edu/tech/rss Cloud

Allow all processes to register a cloud for channel update notifications and implement a lightweight for RSS feeds

Subscription Agreement for the publication. <cloud domain= "rpc.sys.com" port= "path="/RPC2 "

Registerprocedure= "Pingme" protocol= "soap"/>
The TTL TTL is the abbreviation for time to live. It indicates the effective save time for the cache. <ttl>60</ttl>
Image address of image displayed with the channel
Rating this channel's statistical picture address
TEXTINPUT Specifies a textbox to display with the channel
Skiphours tells the user which periods are negligible
Skipdays tells you which days are ignored.

<channel> child Nodes <image>
<image> is an optional <channel> child node that contains three required child elements and three optional child elements.
<url> is the URL address of a GIF, JPEG, or PNG image file that represents the entire channel
<title> used to describe the image above, equivalent to the ALT attribute of in the HTML language
<link> is the URL of the site to connect to, and the connection to the image points to the site when the channel is displayed.
<title> and <link> should have the same value as the channel <title> and <link>
Optional nodes include <width> and <description> is the text in the title attribute of link, which will be displayed when the page is invoked.

The maximum image width is 144, and the default value is 88
The maximum image height is 400, and the default value is 31.

<channel> child Nodes <cloud>
<cloud> is an optional <channel> child node.
It specifies a Web service that can support the Rsscloud interface, Rsscloud interfaces can be http-post,

XML-RPC or SOAP1.1 implementation.
Its purpose is to allow notifications to be registered as cloud for the process channel to be updated, thereby implementing a lightweight release subscription protocol.
<cloud domain= "rpc.sys.com" port= "path="/RPC2 "

Registerprocedure= "Mycloud.rsspleasenotify" protocol= "xml-RPC"/>

In this example, to request a channel notification, you need to send an XML-RPC message to the rpc.sys.com 80 port,

The path is/RPC2. The procedure called is mycloud.rsspleasenotify.

<channel> child Nodes <ttl>
<ttl> is an optional <channel> child node.
The TTL is the abbreviation for time to live. It represents the time at which the channel should be cached before being refreshed. This makes the RSS feed

Can be managed by a network that supports file sharing, such as Gnutella
such as:<ttl>60</ttl>

<channel> child Nodes <textInput>
<textInput> is the optional child node of <channel>,<textinput> contains four child nodes.
<title>--the label of the Submit button
<description>--the description of the text input area
<name>--the name of the text entry area
<link>--the URL of a CGI script that handles text input
The purpose of using <textInput> is somewhat mysterious (? ）。 You can use it to provide a search engine input box,

or let the reader provide feedback. Many aggregators ignore the node.

<item> 's node
A channel can contain many item nodes. A project can represent a story-for example

A newspaper or magazine story, and if so, the description of the project is the summary of the story,

The link to the project points to where the whole story is stored. All nodes of the project are optional, but at least

Contains at least one caption (title) and description (description).

Element Description Example
Title Item Venice Film Festival tries to Quit sinking
Link Item's URL http://www.nytimes.com/2002/09/07/movies/07FEST.html
Description Item Overview Some of the most heated chatter at the Venice Film

Festival this

Week was about the way, the arrival of the stars at the Palazzo

Del Cinema was being staged.
Author author's email address oprah@oxygen.net
Category item can be included in one or more categories Simpsons Characters
Comments the address of the item-related comment http://www.myblog.org/cgi-local/

mt/mt-comments.cgi?entry_id=290
Enclosure the attached Media Object
A GUID can uniquely determine the string of the item HTTP://INESSENTIAL.COM/2002/09/01.PHP#A2
pubdate Item Release time Sun, May 2002 15:21:36 GMT
Source RSS Channel from quotes of the day

<item> child Nodes <source>
<source> is an optional node for <item>.
Its value is the name of the RSS channel that item comes from, derived from title of item. It has a property URL that must be included.

This property is linked to an XML serialization source.
<source url= "Http://static.userland.com/tomalak/links2.xml" >

Tomalak ' s realm</source> the role of the node is to enhance the reputation of the connection, and further promote the source of news items.

It can be used in the post command of the aggregator. When an item is accessed from an aggregator via Webblog,<source>

can be generated automatically.

<item> child Nodes <enclosure>
<enclosure> is an optional node for <item>.
It has three necessary properties. The URL property indicates the position of the enclosure, and length indicates its byte size,

The type attribute indicates its standard MIME type
The URL must be an HTTP URL.
<enclosure Url=http://www.scripting.com/mp3s/weatherreportsuite.mp3

Length= "12216320" type= "Audio/mpeg"/>
<item> child Nodes <category>
<category> is an optional node for <item>.
It has an optional attribute or field, which is a string used to define the taxonomy.
The value of the node is a forward-slash-split string that is used to identify a hierarchical position (hierarchic location) in the specified taxonomy. The processor can establish a session for classification recognition. (Processors may establish conventions for the interpretation of categories)

Here are two examples:
<category>grateful dead</category>
<category domain= "Http://www.fool.com/cusips" >MSFT</category> you can follow

Your needs for different domains (domain) contain many category nodes, and can be different in the same domain

The section has a reference item.

<item> child Nodes <pubDate>
<pubDate> is an optional node for <item>.
Its value is the date on which item was published. If it is a date that does not arrive, the aggregator arrives at the date of the

You can choose not to display the item before.
<pubdate>sun, May 2002 15:21:36 gmt</pubdate>

<item> child Nodes <guid>
<guid> is an optional node for <item>.
GUIDs are abbreviations for globally unique identifier. It is a string that uniquely identifies the item.

When item is published, the aggregator can choose to use the string to determine whether the item is new.
<guid>http://some.server.com/weblogItem3207</guid>
GUIDs have no specific syntax rules, and the aggregator must treat them as a string. To generate a unique string

The GUID depends on the source of the seed.
If the GUID node has a Ispermalink attribute and the value is true, the reader considers it to be the permalink of the item.

Permalink is a URL link that can be opened in a Web browser, pointing to all the item described by the <item> node.
<guid ispermalink= "true" >http://inessential.com/2002/09/01.php#a2</guid>

Ispermalink is an optional attribute, and the default value is true. If the value is False, the GUID will not be considered a URL or

A URL that points to any object.

<item> child Nodes <comment>
<comment> is an optional node for <item>.
If it appears, it points to the URL of the item comment
<comments>

http://rateyourmusic.com/yaccs/commentsn/blogId=705245&itemId=271

</comments>

<item> child Nodes <author>
<author> is an optional node for <item>.
It is the email of the item's author. For newspapers and magazines that are propagated through RSS, the author may be writing the item

The person who described the article. For clustered webblogs, the author may not be an editor or a webmaster. For the webblog of personal maintenance, it is meaningful to ignore <author> nodes.
<author>lawyer@boyer.net (lawyer Boyer) </author>