| Timeline format/zh-hans | |
|---|---|
| 采用交互式时间轴（interactive timelines）来显示查询结果 | |
| 更多信息 | |
| 提供者： | Semantic Result Formats（语义结果格式）/zh-hans |
| 添加版本： | 1.4.0 |
| 移除版本： | 依然支持 |
| 需求： | 无 |
| 格式名称： | timeline |
| 启用？表明安装相应扩展时是否默认启用该结果格式。 | 是 |
| 作者： | Markus Krötzsch , Jeroen De Dauw |
| 分类： | misc |
| 目录 | |
请注意：该结果格式目前需要一名维护人员。详情请联系Jeroen De Dauw。
时间轴格式timeline用于采用交互式时间轴（interactive timelines）来显示查询结果。 直到Semantic MediaWiki 1.3.0版为止，此格式一度乃是SMW的组成部分，而现在则是Semantic Result Formats（语义结果格式）扩展的组成部分。显然，只有那些包含日期的结果才能采用这种方式来显示。 只有当启用JavaScript的情况下，此格式方可有效。 它与事件轴（eventline）格式非常类似。
参数[edit]
时间轴格式在查询之中将采用适合于日期型数据类型属性的打印输出语句。 尽管有若干的查询结果，而时间轴却依然为空白，如果发生这种情况，通常是因为没有为日期数据指定打印输出。 时间轴通常将采用第一个日期以及可选的第二个日期，并将每个结果分别显示为单独一个点（提供的是一个日期时）或者时间段（提供的是两个日期时）。 所有其他的打印输出语句均将显示在点击相应条目时才出现的工具提示框（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 | 请指定传递给该模板的变量 |
示例[edit]
{{#ask: [[News date::+]] [[language code::en]]
| ?news date
| sort=news date
| order=descending
| format=timeline
| timelinebands=MONTH,YEAR
| timelineposition=end
| limit=10
}}
该查询将会产生下列输出：
评注[edit]
时间轴可能会延长页面加载时间，尤其是当要显示大量的事件时。有益的做法就是，采用较小的限值，使时间轴保持更加易于浏览器管理的状态。
结果的排序对于时间轴的显示没有任何影响，因为时间轴始终按照年代/时间顺序来显示事件。不过，排序则可能非常有利于选择，比如，用于显示的十个最新事件，而不是十个任意事件。
本文档页面适用于SMW从1.4.0版到最新版本的所有版本。
其他语言： de
