RSS 2.0规范

来源:百度文库 编辑:神马文学网 时间:2024/04/29 01:26:50
英文原版请参见http://blogs.law.harvard.edu/tech/rss
RSS是 Really Simple Syndication的缩写(对rss2.0而言,是这三个词的缩写,对rss1.0而言则是RDF Site Summary的缩写,1.0与2.0走的是两个体系)
RSS 基于XML,所有的 RSS 必须遵循w3c网站上公布的XML 1.0 规范。
在一个RSS文档中,根元素是,带有一个必备属性version,用以指明该文档遵循的rss规范,如果rss文档遵循本规范,则version值必须是2.0。
元素只有一个子元素,包含关于频道的一些信息。频道(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指定频道所属的一个或几个类别可选Newspapers
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.可选
ttl有效期,用以指明该频道可被缓存的最长时间分钟为单位可选60
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的文档资料- -
什么是 RSS?
RSS 是一种站点内容聚合的格式。
它的名字是Really Simple Syndication 的的简写。
RSS是XML的一种。所有的RSS文档都遵循 XML 1.0规范, 该规范发布在W3C网站上。
这里是RSS版本历史的一个概要。
在一个RSS文档中,最外层是一个元素,这个元素必须规定version属性,该属性明确了本文档遵从何种RSS版本规范。如果一个RSS文档以这个规范来表示,那么它的version属性就必须是2.0。
元素只有一个子元素,包含了关于这个频道(元数据)和它的内容的一些信息。
样本文件
这里有一些RSS样本文件: RSS 0.91, 0.92 和 2.0。
注意这些样本文件所指向的链接地址和服务器可能已经不再存在。在撰写0.91文档的时候,这个0.91的样本文件就已经创建了。维护一个样本文件的历史也许是一个不错的主意。
关于本文档
本文档完成于2002年秋天,版本为 2.0.1。
它包含从 RSS 0.91 规范(2000年)开始的所有的修改和添加,以及包含在RSS 0.92 (2000年12月)和RSS 0.94(2002年8月)中的新的特性。
本文档中首先介绍必须的和可选的频道元素;接着介绍了的子元素。最后回答了一些经常碰到的问题,并提供了未来的发展路线和RSS扩展的指导方针。
必需的频道元素
下面是一个必须包含的频道(channel)元素的列表,每一个都有一个简单的描述、一个例子、应该出现的位置和更详细描述的链接地址。
01.● title
名称:title
描述:频道的名称。它表明别人如何访问你的服务。如果你有一个与你的RSS文件内容一致的HTML网站,你的title元素值应该与你的网站的标题相同。
例子:GoUpstate.com 的新闻大字标题。
02.● link
名称:link
描述:对应频道的网站的URL链接地址。
例子:http://www.goupstate.com/ 。
03.● description
名称:description
描述:关于频道的描述。
例子:The latest news from GoUpstate.com, a Spartanburg zhoujinhui Web site。
可选的频道元素
下面是一个可选的频道(channel)元素的列表。
01.● language
名称:language
描述:频道使用的语言。比如,在一个网站上,允许聚合所有的意大利语站点到相应的分组。对于这个元素,可使用的值,参阅 Netscape提供的清单。或者可以参阅W3C定义的 清单。
例子:en-us。
02.● copyright
名称:copyright
描述:频道内容的版权声明。
例子:Copyright 2002, Spartanburg
03.● managingEditor
名称:managingEditor
描述:频道内容责任编辑的电子邮件地址。
例子:zhoujinhui@blogchina.com
04.● webMaster
名称:webMaster
描述:频道技术支持人员的电子邮件地址。
例子:zhoujinhui@blogchina.com
05.● pubDate
名称:pubDate
描述:频道内容发布的日期。所有的日期和时间都必须遵循 RFC 822规范, 但年份可以用2个或4个字母表示(首选4个字母)。
例子:Sat, 07 Sep 2002 00:00:01 GMT
06.● lastBuildDate
名称:lastBuildDate
描述:频道内容的最后修改时间。
例子:Sat, 07 Sep 2002 09:42:31 GMT
07.● category
名称:category
描述:指定频道所属的一个或多个分类。遵循与item级category元素相同的规则。
例子:Newspapers
08.● generator
名称:generator
描述:表明生成频道的程序名称的字符串。
例子:MightyInHouse Content System v2.3
09.● docs
名称:docs
描述:指向该RSS文件所用格式说明文档的URL链接地址。
例子:http://blogs.law.harvard.edu/tech/rss。
10.● cloud
名称:cloud
描述:允许通过注册一个cloud来处理获得频道的更新通知,并为rss种子实现一个轻量级的发布订阅协议,
例子:
11.● ttl
名称:ttl
描述:ttl是Time to live的缩写,表示生存时间。它表示频道从源更新之前可以缓存的时间。
例子:60。
12.● image
名称:image
描述:指定一个可以在频道中显示的GIF、JPEG或者 PNG 图像。
例子:。
13.● rating
名称:rating
描述:频道的 PICS 内容分级信息。
例子: 。
14.● textInput
名称:textInput
描述:指定一个可以在频道中显示的文本输入框。
例子:。
15.● skipHours
名称:skipHours
描述:提示聚合器,可以跳过那些小时的时间段。
例子:。
16.● skipDays
名称:skipDays
描述:提示聚合器,可以跳过那些天的时间段。
例子:。
的子元素
是 的一个可选子元素, 它本身包含了三个必须的和三个可选的子元素。
是一个GIF、JPEG或PNG图像文件的URL链接地址,该图像代表整个频道。