服务链接

来自semantic-mediawiki.org
跳转到:航行,搜索
目录

语义媒体Wiki可以提供在线服务链接在中打印某些数据时事实箱,在特殊页上特殊页面“浏览”显示注释到页面的所有属性及其值和属性页上的。

例如,当一篇文章包含地理坐标时,提供到在线地图服务的链接是很有用的,这样用户就可以一键检索该位置的地图。另一个示例是提供一个指向财务金额在线货币转换器的链接。本页介绍如何将这些功能添加到语义wiki。

属性的服务链接[编辑]

factbox和特殊页面Browse中指向在线服务的其他链接的信息与财产已使用。例如,此wiki的属性:具有坐标如果在wiki页面上使用,将在factbox和特殊页面Browse上显示指向在线地图的各种链接,而其他属性也使用数据类型地理坐标可能不会显示此内容。这在许多应用程序中都是至关重要的,因为数据类型本身通常并不能说明链接的类型。例如,数据类型的属性“IMDb编号”编号可能用于以下位置的电影id号IMDb公司,但并非数据类型Number的每个属性都应显示到IMDb的链接。

要创建属性显示服务链接,请添加特殊属性提供服务在其页面上。例如,页面Property:Has坐标可能包括注释

[[提供服务::在线地图]]

这里,“在线地图”是维基提供的一组服务链接的名称。下一节将解释如何指定这些服务链接。

指定属性提供服务链接后,其属性值将在factbox、特殊页面Browse和属性自己的页面上显示图标(服务链接图标)单击时显示服务链接的。

截至语义媒体Wiki 2.1.02015年1月19日发布,与MW 1.19.0-1.24.x兼容。服务链接将不再显示在事实箱因为链接的标签不再正常工作。

提供服务链接[编辑]

简而言之,wiki管理员将指定服务链接外观的文本放在“MediaWiki”命名空间中的系统消息文章中。

通常只有具有sysop系统wiki中的(管理员)权限可以在MediaWiki名称空间中添加或编辑页面,因此只有他们才能修改服务链接。

这对大多数wiki来说是一个合理的限制:因为服务链接可能出现在数千个factbox中,所以它们需要被信任。在管理员实施更改之前,通常应该在许多用户之间讨论添加或修改服务。

然而,所有用户都可以自由地将属性与上述可用服务相关联。

系统消息的名称[编辑]

系统消息的格式为MediaWiki:Smw服务服务名称。“MediaWiki:Smw服务”部分始终保持不变,而服务名称随着提供服务链接的每个系统消息而更改。

继续我们的示例具有坐标,的文本[[提供服务::在线地图]]在消息名称中MediaWiki:Smw服务在线地图.

系统消息的内容[编辑]

如果你看看MediaWiki:Smw服务在线地图虽然由于行太长,消息可能很难阅读,但其格式基本如下:

标签文本1|网址:http://someurl.com标签文本2|http://anotherurl.org...

每行包含一个服务链接。这个标签是用户将在服务链接弹出窗口中看到的文本。管道符号“|”之后是统一资源定位地址链接将导致的结果。为了更好地理解,请单击页面顶部的“查看源代码”以查看页面的原始文本。

系统消息中的占位符[编辑]

在大多数情况下,您希望从链接中的属性值中提供信息。例如,到在线地图服务的链接必须包括要显示的坐标,到电影网站的链接必须包含电影的ID。由于事先不知道确切的数据值,因此可以使用表单的占位符$1,$2,$3等。例如,指向IMDb的服务链接的消息文本可以是:

IMDb公司|http://www.imdb.com/title/tt$1/

当SMW显示属性值的服务链接时,它会用属性值的信息替换这些占位符。在这个IMDB示例中,Type:Number的电影ID将用数字值替换$1,也就是说,电影的服务链接链接到IMDB上的信息,例如“0019254”到http://www.imdb.com/title/tt0019254/!

为每个占位符传递的信息[编辑]

替换的参数的数量和内容$1,$2,$3,…取决于数据类型财产的所有权。

例如,数据类型number的简单属性用其值替换$1,而地理坐标则提供纬度、经度、方向等参数。在大多数情况下,$1是最相关的参数,它只提供属性值的URL-safe字符串版本。下面列出的数据类型支持服务链接。所有其他数据类型都不支持服务链接。

帮助:数据类型“页面”
$1:URL编码的文章名称(无名称空间),下划线由空格替换
帮助:数据类型“数字”
$1:英文标点符号中的数值
$2:值的整数版本,英文标点符号
$3:自SMW 1.1版起单位(如有)。
帮助:数据类型“字符串”(但不是帮助:数据类型“文本”)
$1:URL编码字符串
帮助:数据类型“URL”,帮助:数据类型“注释URI”
$1:URL的URL编码值
帮助:数据类型“电子邮件”
$1:URL的URL编码值,包括邮寄地址:
帮助:数据类型“地理坐标”
注意:您需要地图(以前叫语义地图)0.6.5和SMW 1.5.1或更高版本。
$1:非定向浮点表示法中的位置。
$2:DMS定向符号中的位置。
$3:非定向浮点表示法中的纬度。
$4:非定向浮点表示法中的经度。

由于地理坐标很复杂,因此默认消息的示例内容MediaWiki:Smw服务在线地图此wiki上提供了。

服务链接和外部标识符之间的差异[编辑]

为了说明服务链接功能和数据类型“外部标识符”保存一个值,该值将其与用于格式化的外部URI相关联,请参阅第页的示例维也纳.

服务链接[编辑]

对于服务链接属性:Wikidata ID是用特殊财产设立的[[提供服务::Wikidata]]此外,页面MediaWiki:Smw_service_wikidata指定服务的链接。当您单击浏览属性指向维也纳的链接,鼠标悬停后,您可以看到带有服务链接的问号。

外部标识符[编辑]

属性本身是使用设置的数据类型“外部标识符”保存一个值,该值与用于格式化的外部URI相关联(这与服务链接无关)。以类似的方式,您必须指定uri,这一次是在属性页上:[[外部格式化程序uri::https://www.wikidata.org/wiki网站/$1]]结果是,该值本身可以单击,但它不会指向SMW中的页面,而是指向Wikidata。

此示例显示了将SMW中管理的内容映射到Wikidata ID的可能方法。另请参见语义媒体Wiki和Wikidata.