Help:事件轴格式

From semantic-mediawiki.org
Jump to: navigation, search
事件轴格式
采用交互式事件轴(interactive eventlines)来显示查询结果
进一步的信息
提供方: Semantic Result Formats(语义结果格式)
最低版本: 1.4.0
最高版本: 依然支持
要求:
格式名称: timeline
作者: Markus Krötzsch, Jeroen De Dauw
类别: misc
目录

请注意:该结果格式目前需要一名维护人员。详情请联系Jeroen De Dauw

事件轴格式eventline用于采用交互式事件轴(interactive eventlines)来显示查询结果。 直到SMW 1.3版为止,此格式一度乃是SMW的组成部分,而现在则是Semantic Result Formats(语义结果格式)扩展的组成部分。显然,只有那些包含日期的结果才能采用这种方式来显示。 只有当启用JavaScript的情况下,此格式方可有效。 它与时间轴(timeline)格式非常类似。

参数

事件轴格式在查询之中将采用适合于日期型数据类型属性的打印输出语句。 尽管有若干的查询结果,而事件轴却依然为空白,如果发生这种情况,通常是因为没有为日期数据指定打印输出。 事件轴将会把打印输出之中的所有日期均显示为分散的点。 因此,具有5个打印输出数据点的查询,就会在时间轴上分别为它们创建一个点。 不同的颜色用于提供某种视觉提示,表明究竟哪个点属于哪项结果。 同样,工具提示框(tooltips)会显示出所有的细节信息。 所有其他的打印输出语句均将显示在点击相应条目时才出现的工具提示框当中。

事件轴格式额外引入了下列参数:

  • timelinebands(时间轴条带):定义的是结果当中究竟显示哪些条带(bands)。可用的条带有DECADE(十年)、YEAR(年份)、MONTH(月份)、WEEK(星期)以及DAY(日)。如下文范例所示,应当按照由细到粗的顺序给出各个条带,并且采用英文逗号加以分隔。
  • timelineposition(时间轴位置):定义的是时间轴最初的焦点位于何处。可能取值有start(最早的条目)、middle(中间的条目)、end(最晚的条目)以及today(今天)。
  • timelinestart(时间轴起始时间点):可用于定义某个具体的,在时间轴timeline之中用作第一时间点的打印输出(属性)名称。
  • timelineend(时间轴结束时间点):可用于定义某个具体的,在时间轴timeline之中用作第二时间点的打印输出(属性)名称。
  • timelinesize(时间轴尺寸):可用于给出时间轴的高度。默认值为300px
参数 类型 默认 说明
timelinesize 文本 300px 时间轴高度
timelineposition 文本 middle 定义时间轴最初的焦点位于何处。
timelinestart 文本 空白 用来定义第一个时间点的属性名称
timelineend 文本 空白 用来定义第二个时间点的属性名称
timelinebands 文本列表 MONTH, YEAR 定义在结果当中显示哪些条带。
template 文本 空白 输出显示模板的名称
named args 布尔值 no 请指定传递给该模板的变量

示例

{{#ask: [[News date::+]] [[language code::en]]
| ?news date
| sort=news date
| order=descending
| format=eventline
| timelinebands=MONTH,YEAR
| timelineposition=end
| limit=10
}}

该查询将会产生下列输出:

You need to have JavaScript enabled to view the interactive timeline. Further results for this query.

评注

事件轴可能会延长页面加载时间,尤其是当要显示大量的事件时。有益的做法就是,采用较小的限值,使事件轴保持更加易于浏览器管理的状态。

结果的排序对于时间轴的显示没有任何影响,因为时间轴始终按照年代/时间顺序来显示事件。不过,排序则可能非常有利于选择,比如,用于显示的十个最新事件,而不是十个任意事件。



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

Help:Eventline format zh-hans 1.4.0