该篇文章是我于2009年6月10日通过自己编写的工具,批量从位于在博客园的博客站点(http://chenxizhang.cnblogs.com)同步而来。文章中的图片地址仍然是链接到博客园的。特此说明! 陈希章原文地址:http://www.cnblogs.com/chenxizhang/archive/2008/08/22/1274222.html原文标题:RSS 规范 【转载】 原文发表:2008/8/22 8:34:00 |
【本文转载自http://www.playes.net/Blog/226.asp】
什么是 RSS?
RSS是一种网页内容联合格式(web content sydication format)。 它的名字是 Really Simple Syndication 的缩写。 RSS是XML的一种。所有的RSS文档都遵循XML 1.0规范,该规范发布在W3C网站上。
在一个RSS文档的开头是一个<rss>节点和一个规定的属性version,该属性规定了该文档将以RSS的哪个版本表示。如果该文档以这个规范来表示,那么它的version属性就必须等于2.0。
在<rss>节点的下一级是一个独立的<channel>节点,该节点包含关于channel的信息和内容。
关于本文档
该文档是在 2002 年秋天撰写的,当时的 RSS 版本为 2.0.1。 它包含从 RSS 0.91 规范(2000年)开始的所有的修改和添加,以及包含在RSS 0.92(2000年12月)和RSS 0.94(2002年8月)中的新的特性。
必需的频道节点
下面有一份必须包含的频道(channel)节点的列表,每一个都有一个简单的描述、一个例子、应该出现的位置和更详细描述的超链接。
元素 描述
title 频道(channel)名称。它可以告诉别人如何访问你的服务。
link 响应该频道的网站的URL
description 关于该频道的描述
可选的频道元素
元素 描述 范例
language 使用的语言。这允许聚合器对所有的意大利语站点分组。
copyright 版权声明
managingEditor 内容负责人的Email
webMaster 技术人员的Email
pubDate 内容的发布时间: Sat, 07 Sep 2002 00:00:01 GMT
lastBuildDate 最后更新时间: Sat, 07 Sep 2002 09:42:31 GMT
category 指定该频道所属的一个或多个分类。遵循与item级category元素相同的规则。
generator 生成该频道的程序名称
docs 指向rss格式文档的url地址? http://blogs.law.harvard.edu/tech/rss
cloud 允许所有进程注册一个cloud用于获得频道的更新通知,并为rss种子实现一个轻量级的发布订阅协议。
ttl ttl是Time to live的缩写。它指示cache的有效保存时间。
60
image 与频道一起显示的图片地址
rating 该频道的统计图片地址
textInput 指定一个textbox与该频道一起显示
skipHours 告诉使用者哪些时段是可以忽略的
skipDays 告诉使用着哪些天是可以忽略的
子节点
是一个可选的
子节点,该节点包含三个必需的子元素和三个可选的子元素。
是GIF、JPEG或PNG图像文件的URL地址,该图像代表整个频道
>是要连接的站点的url,当显示频道时,图像的连接指向该站点。
可选的节点包括 和 ,它们是数字类型,指定图像的宽度和高度,单位为像素
就是link的TITLE属性中文本,它将在调用网页时显示出来。
图像宽度的最大值为144,默认值为88
图像高度的最大值为400,默认值为31
子节点
是一个可选的
子节点。
它指定一个可以支持rssCloud接口的web服务,rssCloud接口可以用HTTP-POST,XML-RPC或SOAP1.1实现。
它的目的是允许通知注册为cloud的进程频道被更新,从而实现一个轻量级的发布订阅协议。
registerProcedure= "myCloud.rssPleaseNotify" protocol="xml-rpc" />
在这个例子中,为了请求频道通知,你需要发送一个XML-RPC消息到rpc.sys.com的80端口,路径为/RPC2。调用的过程为myCloud.rssPleaseNotify。
子节点
是一个可选的
子节点。
ttl是time to live的缩写。它表示频道在被刷新前应该被缓存的时间。这使得rss源可以被一个支持文件共享的网络所管理,例如Gnutella
例如:
60
子节点
是
的可选的子节点,
包含四个子节点。
--该文本输入区的描述
--文本输入区的名称
>--处理文本输入的CGI脚本的URL
使用 的目的有些神秘(?)。你可以用它提供一个搜索引擎输入框,或让读者提供反馈信息。许多聚合器忽略该节点。
的节点
一个频道可以包含许多项目(item)节点。一个项目可以代表一个故事——比如说一份报纸或杂志上的故事,如果是这样的话,那么项目的描述则是故事的概要,项目的链接则指向整个故事的存放位置。项目的所有节点都是可选的,但是至少要包含至少一个标题(title)和描述(description)。
元素 描述 范例
title item的标题
link item的URL
description item概要
author 作者的email地址
category item可以包含在一个或多个分类中
comments 与item相关的评论的地址
enclosure 附加的媒体对象
guid 可以唯一确定item的字符串
pubDate item发布的时间: Sun, 19 May 2002 15:21:36 GMT
source rss频道来源: Quotes of the Day
子节点
它的值是item来自的rss频道的名称,从item的title衍生而来。它有一个必须包含的属性url, 该属性链接到XML序列化源。
是
的可选节点。
它有三个必要的属性。url属性指示enclosure的位置,length指出它的字节大小,type属性指出它的标准MIME类型
url必须为一个http url。
子节点
是
的可选节点。
它有一个可选属性或域,该属性是一个用来定义分类法的字符串。
该节点的值是一个正斜杠分割的字符串,它用来在指定的分类法中识别一个分级位置(hierarchic location)。处理器可以为分类的识别建立会话。(Processors may establish conventions for the interpretation of categories)下面有两个例子:
Grateful Dead
MSFT
你可以根据你的需要为不同的域(domain)包含很多category节点,并且可以在相同域的不同部分拥有一个前后参照的item。
是
的可选节点。
它的值是item发布的日期。如果它是一个没有到达的日期,聚合器在日期到达之前可以选择不显示该item。
Sun, 19 May 2002 15:21:36 GMT
是
的可选节点。
guid是globally unique identifier的缩写。它是一个可以唯一识别item的字符串。当item发布之后,聚合器可以选择使用该字符串判断该item是否是新的。
http://some.server.com/weblogItem3207
guid没有特定的语法规则,聚合器必须将他们看作一个字符串。生成具有唯一性的字符串guid取决于种子的源头。
如果guid节点有isPermaLink属性,并且值为真,读取器就会认为它是item的permalink。permalink是一个可在web浏览器中打开的url链接,它指向
节点所描述的全部item。
http://inessential.com/2002/09/01.php#a2
isPermaLink是可选属性,默认值为真。如果值为假,guid将不会被认为是一个url或指向任何对象的url。
是
<item>
的可选节点。
<br>如果出现,它指向该item评论的url
<br>
<strong>
<author></author></strong>
<br>
<author>
是
<item>
的可选节点。
<br>它是item的作者的email。对于通过rss传播的报纸和杂志,作者可能是写该item所描述的文章的人。对于聚集型webblogs,作者可能不是责任编辑或站长。对于个人维护的webblog,忽略
<author>
节点是有意义的。
</author>
</item>
</author>
</item>
作者:陈希章 出处:http://blog.youkuaiyun.com/chen_xizhang 本文版权归作者所有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。 |