RSS介绍、RSS 2.0规范说明和示例代码

 2018-11-24 07:58

RSS是一种消息来源格式规范,用以发布经常更新资料的网站,例如博客、新闻的网摘。RSS文件,又称做摘要、网摘、更新、频道等,包含了全文或节选文字,再加上一定的属性数据。RSS让发布者自动发布信息,也使读者能够聚合和定期更新不同网站的网摘。RSS可以通过以网页或桌面为架构的软件来阅读,即RSS阅读器、新闻聚合器等,并进行定期更新检查、自动下载。

RSS可以是以下三种解释中任一种的缩写,

RSS规范的主要版本有0.91、1.0和2.0等。

早期版本的RSS阅读器不支持RDF分支,而当前主流的RSS阅读器都同时兼容两种分支。

RSS 2.*规范由美国人Dave Winer个人进行维护,在全球大部分网站得到使用。可能是版权方面的原因,RSS 2.*规范并没有在W3CIETF或者ISO等国际标准化组织发布,而是在RSS Advisory Board发布。

RSS 2.0规范说明

RSS标志

本规范是RSS 2.0规范的2.0.10版本,2007-10-15在RSS Advisory Board发布,波波坡原创翻译。点击这个链接可以获得RSS的最新版本的英语规范。

RSS是一个Xml格式的数据或文件,根节点是一个带有版本号的<rss>节点,根节点一下是一个单一的<channel>节点极其子节点。对于具体的Rss订阅项目,例如一篇文章、网志,由<channel>节点下多个<item>节点来表示。一个<channel>可以有任意多个<item>。

<channel>

必须的子节点:

项目说明举例
<title>频道名称。程序员的波波坡。
<link>与频道关联的Web站点或者站点区域的Url。http://www.bobopo.com
<description>简要介绍该频道是做什么的。包含编程、休闲、知识、杂记的程序员站点。

可选的子节点:

项目说明举例
<language>频道内容使用的语言。详见常用HTML、RSS语言代码列表zh-cn
<copyright>频道内容的版权说明。Copyright 2008,2009 bobopo.com
<managingEditor>责任编辑的Email地址。rosbicn@hotmail.com
<webMaster>频道相关网站管理员的Email地址。rosbicn@hotmail.com
<pubDate>频道内容发布日期。遵循RFC 822Wed, 04 Mar 2009 00:00:01 GMT
<lastBuildDate>频道内容最后的修改日期。遵循RFC 822Wed, 04 Mar 2009 09:42:31 GMT
<category>频道所属的一个或几个类别。详见后文。Html
<generator>生成该频道的程序名字符串。Bobopo Site Generator 2009
<docs>解释当前RSS文件的文档的Url。(给不知道啥是RSS的某人看:)http://www.bobopo.com/code/rss.htm
<cloud>允许进程注册为“cloud”,频道更新时通知它,为 RSS 提要实现了一种轻量级的发布-订阅协议。详见后文。详见后文。
<ttl>内容有效期,一个数字,指明该频道可被缓存的最长分钟数。60
<image>指定一个 GIF或JPEG或PNG图片,用以与频道一起显示。详见后文。详见后文。
<rating>內容分级,主要指成人、限制、儿童等,多数情况不用,如果要用参见PICS 
<textInput>定义可与频道一起显示的输入框。多数情况不用。详见后文。 
<skipHours>提示新闻聚合器,哪些小时时段它可以跳过。可包含最多24个<hour>子节点,它的值是0~23中的一个数字。<hour>2</hour>
<hour>3</hour>
<skipDays>提示新闻聚合器,那些天它可以跳过。可包含最多7个<day>子节点,它的值是Monday、Tuesday、Wednesday、Thursday、Friday、Saturday或Sunday之一。<day>Saturday</day>
<day>Sunday</day>

<item>

<item>的任何一个子节点都是可选的,但是<title>和<description>至少要被包含一个。

项目说明举例
<title>项目的名称。RSS简介。
<link>项目的Url。http://www.bobopo.com/article/rss.htm
<description>项目的摘要。RSS(简易资讯聚合)是一种消息来源格式规范,用以发布经常更新资料的网站,例如部落格文章、新闻、音讯或视讯的网摘。RSS文件(或称做摘要、网络摘要、或频更新,提供到能道)包含了全文或是节录的文字,……
<author>作者的Email地址。通常忽略。rosbicn@hotmail.com
<category>频道所属的一个或几个类别。详见后文。Html
<comments>与此项目相关的评论的Url。http://www.bobopo.com/comments/rss.htm
<enclosure>此项目相关的多媒体附件。属性url表示附件网址,属性length表示附件字节数,属性type表示附件的MIME类型。<enclosure url="http://www.bobopo.com/video/rss.mp3" length="16131450" type="audio/mpeg" />
<guid>项目的唯一识别码。详见后文。http://www.bobopo.com/article/rss.htm
<pubDate>项目的发布日期。遵循RFC 822Wed, 04 Mar 2009 00:00:01 GMT
<source>项目来源于哪个Rss频道。如果一个Rss是从其他Rss转贴过来,可以用这个。必须包含属性url,指向另外一个rss。<source url="http://www.blabla.cn/rss.xml">Blabla</source>

<item>中支持Html格式的<description>

<item>的子节点<description>可以只包含项目的摘要,也可以是项目全文。它的值是Text类型,或者是一个实体编码的HTML类型(entity-encoded HTML)。所谓实体编码的HTML类型,指的是HTML的保留字(实体)都进行了编码处理。举例如下:

示例1:对HTML标记进行编码。

<description>this is &lt;b&gt;bold&lt;/b&gt;</description>

结果:this is bold

示例2:HTML标记放在CDATA段中编码。

<description><![CDATA[this is <b>bold</b>]]></description>

结果:this is bold

示例3:对尖括号进行编码

<description>5 &amp;lt; 8, ticker symbol&amp;lt;BIGCO&amp;gt;</description>

结果:5 < 8, ticker symbol <BIGCO>

示例4:尖括号放在CDATA段中编码。

<description><![CDATA[5 &lt; 8, ticker symbol &lt;BIGCO&gt;]]></description>

结果:5 < 8, ticker symbol <BIGCO>

<category>

<category>是<channel>的可选子节点,也是<item>的可选子节点,用来表示频道或者内容的类别。一个节点表示一个类别,如果是多个类别,可以用多个<category>节点来表示。如果该类别有专门的Url表示,可以用属性domain来表示。

示例如下,

<category>编程</category>
<category domain="http://www.bobopo.com/html/">Html</category>

<category>有点类似很多网站中的标签(Tag)。

<guid>

guid是全球唯一识别码的意思,用来唯一确定Rss项目的字符串。现在,一个新闻聚合器往往用这个字符串来判断某个项目是不是新的。

guid并没有什么语法上面的规定,新闻聚合器肯定把它视作字符串。建立这个字符串的唯一性取决于项目的内容。往往用项目相关的Url来做guid。

如果<guid>包含属性isPermaLink,并且属性值是true,新闻聚合器会把<guid>的值当做当前项目的永久连接,也就是能够在浏览器中打开,连接到项目全文的Url。isPermaLink是可选属性,缺省值是true,也就是说,如果包含了isPermaLink,只有明确写明值是false,才表示<guid>的值不是Url。

<guid isPermaLink="true">http://www.bobopo.com/article/rss.htm</guid>

<cloud>

这个东西主要是给HTTP-POST、XML-RPC或者SOAP 1.1这类的Web Service用的。如果真的要用,请看这里

项目说明举例
<domain>必须。cloud程序所在机器的域名或IP地址。rpc.bobopo.com
<port>必须。访问cloud程序所通过的端口。80
<path>必须。程序所在路径,不一定需要是真实路径。/RPC2
<registerProcedure>必须。 注册的可提供的服务或过程。cloud.rss
<protocol>必须。协议,http-post、xml-rpc、soap之一。xml-rpc

示例如下,

<cloud domain="rpc.bobopo.com" port="80" path="/RPC2" registerProcedure="cloud.rss" protocol="xml-rpc" />

<image>

项目说明举例
<url>必须。表示该频道的Gif、Jpeg或Png图像的Url。http://www.bobopo.com/style/images/bobopo.gif
<title>必须。图象描述。当频道以Html呈现时用作<img>标签的alt属性。程序员的波波坡。
<link>必须。站点Url,当频道以Html呈现时,该图像会链接到此。http://www.bobopo.com
<width>可选。 数字,图象的像素宽度,最大值144,默认值为88。120
<height>可选。 数字,图象的像素高度,最大值400,默认值为31。120
<description>可选。 当频道以Html呈现时,作为围绕着该图像形成的链接Tag的title属性。包含编程、休闲、知识、杂记的程序员站点。

上述<title>和<link>多数情况下会与<channal>的<title>和<link>相同。

<textInput>

用户可以用<textInput>让读者进行一次搜索引擎的搜索,或者提交一个反馈。不过大多数情况都是忽略这个东西。

项目说明
<title>必须。输入框中Submit按钮上的文字。
<description>必须。输入框的解释。
<name>必须。输入框对象的名字。
<link>可选。 输入框提交的Url。

RSS 2.0代码示<?xml version="1.0"?><rss version="2.0">

  <channel>
    <title>Liftoff News</title>
    <link>http://liftoff.msfc.nasa.gov/</link>
    <description>Liftoff to Space Exploration.</description>
    <language>en-us</language>
    <pubDate>Tue, 10 Jun 2003 04:00:00 GMT</pubDate>
    <lastBuildDate>Tue, 10 Jun 2003 09:41:01 GMT</lastBuildDate>
    <docs>http://blogs.law.harvard.edu/tech/rss</docs>
    <generator>Weblog Editor 2.0</generator>
    <managingEditor>editor@example.com</managingEditor>
    <webMaster>webmaster@example.com</webMaster>
    <item>
      <title>Star City</title>
      <link>http://liftoff.msfc.nasa.gov/news/2003/news-starcity.asp</link>
      <description>How do Americans get ready to work with Russians aboard the International Space Station? They take a crash course in culture, language and protocol at Russia's &lt;a href="http://howe.iki.rssi.ru/GCTC/gctc_e.htm"&gt;Star City&lt;/a&gt;.</description>
      <pubDate>Tue, 03 Jun 2003 09:39:21 GMT</pubDate>
      <guid>http://liftoff.msfc.nasa.gov/2003/06/03.html#item573</guid>
    </item>
    <item>
      <description>Sky watchers in Europe, Asia, and parts of Alaska and Canada will experience a &lt;a href="http://science.nasa.gov/headlines/y2003/30may_solareclipse.htm"&gt;partial eclipse of the Sun&lt;/a&gt; on Saturday, May 31st.</description>
      <pubDate>Fri, 30 May 2003 11:06:42 GMT</pubDate>
      <guid>http://liftoff.msfc.nasa.gov/2003/05/30.html#item572</guid>
    </item>
    <item>
      <title>The Engine That Does More</title>
      <link>http://liftoff.msfc.nasa.gov/news/2003/news-VASIMR.asp</link>
      <description>Before man travels to Mars, NASA hopes to design new engines that will let us fly through the Solar System more quickly.  The proposed VASIMR engine would do that.</description>
      <pubDate>Tue, 27 May 2003 08:37:32 GMT</pubDate>
      <guid>http://liftoff.msfc.nasa.gov/2003/05/27.html#item571</guid>
    </item>
    <item>
      <title>Astronauts' Dirty Laundry</title>
      <link>http://liftoff.msfc.nasa.gov/news/2003/news-laundry.asp</link>
      <description>Compared to earlier spacecraft, the International Space Station has many luxuries, but laundry facilities are not one of them.  Instead, astronauts have other options.</description>
      <pubDate>Tue, 20 May 2003 08:56:02 GMT</pubDate>
      <guid>http://liftoff.msfc.nasa.gov/2003/05/20.html#item570</guid>
    </item>
  </channel>
</rss>


 上一篇  打赏 下一篇 
作者头像

作者:紫铜炉

自由博主,网页设计师。我关注科技产品和个人博客发展,注重用户体验和界面优化。

 发表评论:

 评论列表

网络兼职赚钱 2018-12-13  17:44

写的是真心不错,值得大家学习