RSS 2.0规范

2007-12-18 21:27:45

技术资料 RSS

RSS是 Really Simple Syndication的缩写(对rss2.0而言,是这三个词的缩写,对rss1.0而言则是RDF Site Summary的缩写,1.0与2.0走的是两个体系)。

RSS 基于XML,所有的 RSS 必须遵循w3c网站上公布的XML 1.0规范。

在一个RSS文档中,根元素是 <rss>,带有一个必备属性version,用以指明该文档遵循的rss规范,如果rss文档遵循本规范,则version值必须是2.0。

<rss>元素只有一个子元素,包含关于频道的一些信息。频道(channel)是整个blog,项(item)指一篇文章或日志(也有称这为post)。

RSS2.0元素channel的子元素列表

元素(Element)描述(Description)值域重要性举例(Example)
title频道名称 必备GoUpstate.com News Headlines
link频道的URL 必备http://www.goupstate.com/
Description频道的描述 必备The latest news from GoUpstate.com, a Spartanburg Herald-Journal Web site.
language频道文章所用语言,可用netscape或w3c推荐的列表可选en-us
copyright频道内容的版权说明 可选Copyright 2002, Spartanburg Herald-Journal
managingEditor责任编辑的email 可选geo@herald.com (George Matesky)
webMaster负责频道技术事务的网站管理员email 可选betty@herald.com (Betty Guernsey)
pubDate频道内容发布日期,格式遵循RFC822格式(年份可为2们或4位) 可选Sat, 07 Sep 2002 00:00:01 GMT
lastBuildDate频道内容最后的修改日期 可选Sat, 07 Sep 2002 09:42:31 GMT
category指定频道所属的一个或几个类别 可选<category>Newspapers</category>
generator生成该频道的程序名 可选MightyInHouse Content System v2.3
docs指向该RSS文件所用格式说明的URL 可选http://blogs.law.harvard.edu/tech/rss
cloudAllows processes to register with a cloud to be notified of updates to the channel, implementing a lightweight publish-subscribe protocol for RSS feeds. More info here. 可选<cloud domain="rpc.sys.com" port="80" path="/RPC2" registerProcedure="pingMe" protocol="soap"/>
ttl有效期,用以指明该频道可被缓存的最长时间分钟为单位可选<ttl>60</ttl>
image指定一个 GIF或JPEG或PNG图片,用以与频道一起显示 可选 
rating这个频道的分级(主要指成人、限制、儿童等) 可选 
textInput指定一个text输入框供用户输入,具体信息及功能未定。 可选 
skipHours提示新闻聚合器,那些小时时段它可以跳过。 可选 
skipDays提示新闻聚合器,那些天它可以跳过。 可选 

RSS2.0元素channel的子元素image的子元素列表

元素(Element)描述(Description)值域重要性举例(Example)
url图片的url 必备 
title图片的标题,用于http的alt属性 必备 
link网站的url(实际中常以频道的url代替) 必备 
width图片的宽度(象素为单位)最大144,默认88可选 
height图片的高度(象素为单位)最大400,默认31可选 
description用于link的title属性 可选 

RSS2.0元素channel的子元素cloud的子元素列表

元素(Element)描述(Description)值域重要性举例(Example)
domainCloud程序所在机器的域名或IP地址  radio.xmlstoragesystem.com
port访问clound程序所通过的端口  80
path程序所在路径(不一定是真实路径)  /RPC2
registerProcedure注册的可提供的服务或过程  xmlStorageSystem.rssPleaseNotify
protocol协议xml-rpc, soap , http-post 之一 xml-rpc

RSS2.0元素channel的子元素textInput的子元素列表

元素(Element)描述(Description)值域重要性举例(Example)
titleSubmit按钮的标签 必备 
description解释text输入区 必备 
nameText area对象的名字 必备 
link处理提交的请求的cgi程序 必备 

RSS2.0中ITEM的元素列表

元素(Element)描述(Description)例子(Example)重要性属性
title项(item)的标题Venice Film Festival Tries to Quit Sinking必备 
link项的URLhttp://www.nytimes.com/2002/09/07/movies/07FEST.html必备 
description项的大纲Some of the most heated chatter at the Venice Film Festival this week was about the way that the arrival of the stars at the Palazzo del Cinema was being staged.必备 
author该项作者的emailoprah@oxygen.net可选 
category包含该项的一个或几个分类(catogory)Simpsons Characters可选domain可选,指分类法的URL
comments该项的评论(comments)页的URLhttp://www.myblog.org/cgi-local/mt/mt-comments.cgi?entry_id=290可选 
enclosure描述该附带的媒体对象 可选url/length/type皆必备,type须是标准MIME类型
guid项的唯一标志符串http://inessential.com/2002/09/01.php#a2可选isPermaLink可选,默认为真,指明guid是否为一永久URL。
pubDate项的发布时间Sun, 19 May 2002 15:21:36 GMT可选 
source该项来自的RSS道Quotes of the Day可选Url必备