Help:RSS格式

From semantic-mediawiki.org
Jump to: navigation, search


本文档页面适用于SMW从1.1.0版到1.7.1的所有版本。
      其他语言: deen

Help:RSS format zh-hans 1.1.0 1.7.1



RSS格式
为查询结果打印输出指向RSS提要(RSS feeds)的链接
进一步的信息
提供方: Semantic MediaWiki
最低版本: 1.1.0
最高版本: 1.7.1
要求:
格式名称: rss
作者: Denny Vrandecic, Markus Krötzsch
类别: export, xml
目录

RSS格式 rss用于产生指向RSS提要(RSS feeds)的链接。如Help:嵌入式查询页面所述,这是一种用于数据导出的特殊格式,因此属性必须采用已知的标签,来指定和说明维基站点数据如何与RSS格式相关联。

参数

A fatal error occurred in the #smwdoc parser function

RSS格式额外引入了下列参数:

  • rsstitle(RSS标题):要用作RSS提要标题的文本
  • rssdescription(RSS描述):要用作RSS提要描述的文本

二者均为可选参数。当用于产生RSS提要的查询仅仅是单独一个概念的时候,而且如果没有提供其他取值的话,则相应的概念页面标题和概念描述(如果有的话)即被视为上述参数的默认值。采取这种方式,可以创建较短的URLs,其中不必包含冗长的描述文本。

示例

如下查询的结果对应于本网站主页上所提供的RSS提要:

{{#ask: [[News date::+]] [[language code::en]]
| sort=news date
| order=descending
| format=rss
| searchlabel= RSS
| rsstitle=Semantic MediaWiki
| rssdescription=Latest news from semantic-mediawiki.org
}}

该查询将产生下列输出:

RSS

数据字段

打印输出语句之中的属性应当采用下列标签之一,否则在最终的RSS提要之中将被忽略。 可用的字段有:

  • date(日期):提要元素的日期,必须为日期型
  • creator(创建者):创建这些新闻条目的人员(可为任意数据类型,但常见的是页面型)。

如果未加指定的话,上述参数的默认值就是维基站点之中相应页面的修订日期(modification date)和最后一位编者的姓名。

评注

在大多数的RSS工具上,RSS提要都可以很好地发挥作用,甚至在Firefox浏览器当中还可以用作动态书签(dynamic bookmarks)。 据报告称,对于非常长的URLs,MS Outlook存在着一些问题,因而,如上所述,有益的做法就是利用概念来让URLs变得更短些。

RSS提要之中包含不包含那些所导出文章的全文均可。这是维基网站管理员可以指定的一项全局设置。如果包含全文, 则可利用MediaWiki标记<noinclude>来限制出现在RSS提要当中的文本的数量。