RSS2.0 规范文档
前些天,修改 Windsphoto 相册时,突发奇想,增加 RSS 订阅的功能。以前从来没有真正接触过 XML,难度相当大。最后弄了半天,还是不符合规范,在 Foxmail 等离线阅读器上没办法订阅到,不过总算可以在一些在线阅读上订阅了。
RSS 的规范的确很严格,对于 web 开发人员来说,比较有难度的应该是时间格式的转换。
什么是 RSS?
RSS 是一种站点内容聚合的格式。
它的名字是*Really Simple Syndication *的的简写。
RSS 是 XML 的一种。所有的 RSS 文档都遵循 XML 1.0 规范, 该规范发布在W3C网站上。
在一个 RSS 文档中,最外层是一个
样本文件
这里有一些 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 月)中的新的特性。
本文档中首先介绍必须的和可选的频道元素;接着介绍了
必需的频道元素
下面是一个必须包含的频道(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 Herald-Journal Web site。
可选的频道元素
下面是一个可选的频道(channel)元素的列表。
01.● language
名称:language
描述:频道使用的语言。比如,在一个网站上,允许聚合所有的意大利语站点到相应的分组。对于这个元素,可使用的值,参阅 W3C 定义的 清单。
例子:en-us。
02.● copyright
名称:copyright
描述:频道内容的版权声明。
例子:Copyright 2002, Spartanburg Herald-Journal
03.● managingEditor
名称:managingEditor
描述:频道内容责任编辑的电子邮件地址。
例子:geo@herald.com (George Matesky)
04.● webMaster
名称:webMaster
描述:频道技术支持人员的电子邮件地址。
例子:betty@herald.com (Betty Guernsey)
05.● pubDate
名称:pubDate
描述:频道内容发布的日期。所有的日期和时间都必须遵循 RFC 822规范, 但年份可以用2个或4个字母表示(首选4个字母)。
例子:Sat, 07 Sep 2002 00:00 GMT
06.● lastBuildDate
名称:lastBuildDate
描述:频道内容的最后修改时间。
例子:Sat, 07 Sep 2002 09:42 GMT
07.● category
名称:category
描述:指定频道所属的一个或多个分类。遵循与 item 级 category 元素相同的规则。
例子:
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 的缩写,表示生存时间。它表示频道从源更新之前可以缓存的时间。
例子:
12.● image
名称:image
描述:指定一个可以在频道中显示的 GIF、JPEG 或者 PNG 图像。
例子:。
13.● rating
名称:rating
描述:频道的 PICS 内容分级信息。
例子: 。
14.● textInput
名称:textInput
描述:指定一个可以在频道中显示的文本输入框。
例子:。
15.● skipHours
名称:skipHours
描述:提示聚合器,可以跳过那些小时的时间段。
例子:。
16.● skipDays
名称:skipDays
描述:提示聚合器,可以跳过那些天的时间段。
例子:。
**
可选的元素包括
图像宽度的最大值为 144,默认值为 88。
图像高度的最大值为 400,默认值为 31。
它指定一个可以支持 rssCloud 接口的 web 服务,rssCloud 接口可以在 HTTP-POST、XML-RPC 或 SOAP1.1 中实现。
它的目的是允许通过注册一个 cloud 来处理获得频道的更新通知,从而为 RSS feeds 实现一个轻量级的发布订阅协议.
在这个例子中,为了请求频道通知,你需要发送一个 XML-RPC 消息到 rpc.sys.com 的 80 端口,路径为/RPC2。调用的程序为为 myCloud.rssPleaseNotify。
ttl 是 Time to live 的缩写,表示生存时间。它表示频道从源重新更新之前可以缓存的时间。这使得 rss 源可以被一个支持文件共享的网络所管理,例如Gnutella。
例子:
频道可以选择包含一个
使用
一个频道可以包含许多
01.● title
名称:title
描述:item 的标题。
例子:Venice Film Festival Tries to Quit Sinking
02.● link
名称:link
描述:item 的 URL 链接地址。
例子:http://nytimes.com/2004/12/07FEST.html
03.● description
名称:description
描述:item 的摘要。
例子: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.
04.● author
名称:author
描述:item 作者的电子邮件地址。
例子:。
05.● category
名称:category
描述:包含 item 在一个或多个分类中。
例子:。
06.● comments
名称:comments
描述:与 item 相关的评论的 URL 链接地址。
例子:。
07.● enclosure
名称:enclosure
描述:item 附加的媒体对象。
例子:。
08.● guid
名称:guid
描述:可以唯一确定 item 身份的字符串。
例子:。
09.● pubDate
名称:pubDate
描述:item 发布的时间。
例子:。
10.● source
名称:source
描述:rss 频道来源。
例子:。
它的值是 item 所属 rss 频道的名称,从 title 衍生而来。它有一个必须包含的属性 url, 该属性链接到 XML 序列化源。
该元素的作用是提高链接的声望,从而进一步推广新闻项目的源头。它可以用在聚合器的 Post 命令中。当从聚合器中通过一个 webblog 编辑工具提交一个 item 时,
它有三个必须的属性。url 属性表明 enclosure 的位置,length 属性表明它的字节大小,而 type 属性则指出它的标准 MIME 类型。
这里的 url 必须为一个 http url。
它的 use-case 说明请参见这里。
它有一个可选属性 domain,该属性是一个用来定义分类法的字符串。
该节点的值是一个斜杠分割的字符串,它用来表明在指定的分类法中的层次位置。处理器可以为分类的识别建立协定。以下是两个例子:
你可以根据需要为不同的域包含很多
它的值是一个 日期, 表明项目发布的时间。如果它是一个将来的日期,则聚合器在日期到达之前可以选择不显示该项目。
**
guid 是 globally unique identifier 的缩写。它是一个可以唯一识别这个
guid 没有特定的语法规则。聚合器必须将它们当作一个字符串来处理。生成具有唯一性的字符串 guid 取决于种子的源头。
如果 guid 元素有 isPermaLink 属性,并且值为真,解释器就会认为它是 item 的 permalink。permalink 是一个可在 web 浏览器中打开的 url 链接,它指向
isPermaLink 是可选属性,默认值为真。如果值为假,guid 将不会被认为是一个 url 或指向任何对象的 url。
如果出现,它指向与 item 相关的评论的 url。
**
它是 item 作者的电子邮件地址 l。对于通过 rss 传播的报纸和杂志,作者可能是写该 item 所描述的文章的人。对于聚集型 webblogs,作者可能不是责任编辑或站长。对于个人维护的 webblog,忽略
注释
RSS 限制 和
在 RSS 0.91 规范中,各种元素都被限制为 500 或 100 个字符。在一个符合 0.91 规范的频道中,不能超过 15 个
如上所述,在 RSS 2.0 规范中,对于一个目录系统,当链接一个频道到它的标识中时,使用基于频道级别的分类特征。例如,如果链接一个频道到它的 Syndic8 标识,则将包括一个分类元素作为频道的子元素,它有域 Syndic8 属性,同时在 Syndic8 数据库中为你的频道确定这个标识。正确的分类元素脚本应该是
一个经常被问到的问题是关于< guid> 如何和 进行区别。它们指的是相同的事情吗?在一些内容系统中是,但在别的内容系统中可能不是。在一些系统中, 是一个网络日志项的永久链接。然后在别的系统中,每一个
如果你对 RSS 2.0 规范的格式有任何问题,请向由 Sjoerd Visscher 维护的电子邮件列表RSS2-Support发送邮件。这个邮件列表不是一个技术辩论的列表,而是一个针对作者和开发人员在创建和使用 RSS 2.0 格式的内容时提供技术支持的列表。
RSS 的扩展
RSS 起源于 1999 年,目标是成为一个简单、易于理解的数据格式。在它逐渐成为一种流行格式之后,开发者想在一个名字空间中使用模块对它进行扩展,正像 W3C 定义的那样。
RSS 遵循简单的规则,增加了它的能力。一个 RSS feed 可以包含不是在本页中描述的内容,而只是在一个名字空间中定义的那些元素。
本文档中定义的元素不是一个名字空间本省的元素,因此,RSS2.0 从某种意义上来讲,和原来的版本是兼容的,即一个 0.91 或者 0.92 版本的文件也是一个有效的 2.0 版本文件。如果 RSS2.0 的元素是在一个名字空间中,那么这种约束将被打破,即一个 0.9x 版本的文件不可能是一个有效的 2.0 版本的文件。
发展方向
RSS 决不是一个完美的格式,但是它现在已经非常流行,并得到广泛的支持。要成为一个固定的规范,RSS 需要很长的一段时间。这项工作的目的是帮助 RSS 成为一个固定的事情,同时促进和培育围绕它进行的开发的市场的增长,并为新的聚合格式铺平道路。因此,为了实用的目的,RSS 规范将被冻结在 2.0.2 版本。我们可以预期的可能的 2.0.2 或者 2.0.3 等版本,都只是出于澄清规范的目的,而不是在格式上增加新的特征。后续的工作应该集中在模块化、名字空间的使用和在完全新的聚合格式中用新的名字等方面。
许可协议和作者
RSS 2.0 是在遵循 the Attribution/Share Alike Creative Commons 许可协议的基础上由 the Berkman Center for Internet & Society at Harvard Law School 提供。本文档的作者是 Dave Winer,UserLand software 的创始人,也是 Berkman Center 的员工。(全文完)