README

现代时间线 扩展为 Semantic MediaWiki 提供了现代时间线可视化，作为 Semantic MediaWiki 的结果格式。

该扩展由 Professional.Wiki 创建，并由 KDZ - 公共行政研究中心资助。

示例时间线

平台要求

PHP 7.1 或更高版本（测试至 PHP 8.0）
MediaWiki 1.31.x 或更高版本（测试至 MediaWiki 1.37）
语义MediaWiki 3.0 或更高版本（测试至 SMW 4.0.2）

有关现代时间线不同版本的更多信息，请参阅发行说明。

安装

推荐使用 Composer 以及 MediaWiki 内置的 Composer 支持来安装现代时间线。

注意：根据提供的安装说明，必须首先安装所需的扩展 Semantic MediaWiki。

步骤 1

切换到您的 MediaWiki 安装的基础目录。如果您还没有 "composer.local.json" 文件，请创建一个，并将以下内容添加到其中

{
	"require": {
		"professional-wiki/modern-timeline": "~1.0"
	}
}

如果您已经有 "composer.local.json" 文件，请将以下行添加到文件中 "require" 部分的末尾

"professional-wiki/modern-timeline": "~1.0"

请记住在此部分末尾添加逗号。

步骤 2

在您的 shell 中运行以下命令

php composer.phar update --no-dev

注意：如果您的系统已安装 Git，请向上述命令添加 --prefer-source 标志。

步骤 3

将以下行添加到您的 "LocalSettings.php" 文件的末尾

wfLoadExtension( 'ModernTimeline' );

用法

请参阅以下网站的实时演示： Professional.Wiki Starter 演示维基 - 类别：现代时间线示例。

第一个日期打印输出用作时间线事件的日期

{{#ask:
 [[Modification date::+]]
 |format=moderntimeline
 |?Modification date
}}

如果存在第二个日期打印输出，则用作结束日期，事件显示为范围

{{#ask:
 [[Start date::+]]
 |format=moderntimeline
 |?Start date
 |?End date
}}

时间线的显示和行为可以通过多个输出参数进行更改

{{#ask:
 [[Modification date::+]]
 |format=moderntimeline
 |?Modification date
 |width=75%
 |height=500px
 |start at end=on
}}

参数

通过 wiki 中的 smwdoc 解析函数可以获取支持的所有输出参数的完整列表

{{#smwdoc: moderntimeline }}

配置

所有参数的默认值可以通过在 "LocalSettings.php" 中放置配置来更改。以下配置设置可用

$wgModernTimelineWidth – 时间线宽度，单位为 %。也可以指定为 px、em 和 ex
$wgModernTimelineHeight – 时间线高度，单位为像素。也可以指定为 em 和 ex
$wgModernTimelineBookmark – 通过页面 URL 使时间线可书签
$wgModernTimelineBackground – 时间线幻灯片的背景颜色（CSS 颜色值）
$wgModernTimelineScaleFactor – 首次呈现时的时间线宽度（屏幕宽度）
$wgModernTimelinePosition – 在顶部或底部显示时间线导航
$wgModernTimelineTickWidth – 轴上刻度之间的最佳距离（像素）
$wgModernTimelineStartSlide – 时间线加载时显示的第一个幻灯片
$wgModernTimelineStartAtEnd – 从最后一个时间线幻灯片开始
$wgModernTimelineTransitionDuration – 幻灯片切换持续时间（毫秒）
$wgModernTimelineNavHeight – 时间线导航部分的高度（% 或 px）
$wgModernTimelineTemplate – 显示幻灯片区域的模板名称
$wgModernTimelineImageProperty – 类型为页面的语义属性。需要作为打印请求查询

这些配置设置的默认值可以在 "extension.json" 中找到。不要更改 "extension.json"。

更改配置设置的一个示例

$wgModernTimelineHeight = '500px';

限制

模板参数不支持在 "Special:Ask" 上
时间线样式不会自动匹配维基
时间线语言不会自动匹配维基

有关 Professional.Wiki 的专业 MediaWiki 开发或语义 MediaWiki 托管，请联系。

贡献和支持

如果您想为项目贡献工作，请订阅开发者邮件列表并查看贡献指南。

通过 Professional.Wiki 提供 Professional MediaWiki 支持。

许可

GNU通用公共许可证v2.0或更高版本（GPL-2.0-or-later）.

发行说明

版本 1.2.2

发布于2023年11月9日。

修复了与MediaWiki 1.38及更高版本的兼容性问题
从 https://translatewiki.net 更新了翻译

版本 1.2.1

发布于2022年4月11日。

修复了在某些情况下标题不可用时出现的致命错误

版本 1.2.0

发布于2020年3月29日。

修复了使用MediaWiki 1.34或更高版本时使用 template 参数出现的错误
添加了 image property 参数（带有 image 别名）
添加了 wgModernTimelineImageProperty 配置参数
从 https://translatewiki.net 更新了翻译

版本 1.1.0

发布于2019年8月28日。

改进了对大数据集的处理
从 https://translatewiki.net 更新了翻译

版本 1.0.0

发布于2019年8月16日。

首次发布，使用基于 TimelineJS3 的结果格式，具有12个自定义参数、模板支持和日期范围支持。

专业维基 / 现代时间线

维护者

详细信息