mediawiki/语义复合查询

一个Semantic Mediawiki扩展,用于在一个可视化输出中显示和组合多个 #ask 查询

2.2.0 2022-01-20 17:43 UTC

README

Build Status Code Coverage Scrutinizer Code Quality Latest Stable Version Packagist download count

语义复合查询(简称SCQ)是一个 Semantic Mediawiki 扩展,它定义了 #compound_query 解析函数,可以在同一时间显示多个 #ask 查询(作为复合结构)的结果。

要求

  • PHP 7.3或更高版本
  • MediaWiki 1.31或更高版本
  • Semantic MediaWiki 3.0或更高版本

安装

推荐使用 Composer 以及 MediaWiki的内置Composer支持 来安装语义复合查询。

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

步骤 1

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

{
	"require": {
		"mediawiki/semantic-compound-queries": "~2.2"
	}
}

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

"mediawiki/semantic-compound-queries": "~2.2"

请记得在这个部分末尾添加一个逗号。

步骤 2

在您的shell中运行以下命令

php composer.phar update --no-dev

注意,如果您在系统中安装了Git,请在上面的命令中添加--prefer-source标志。

步骤 3

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

wfLoadExtension( 'SemanticCompoundQueries' );

用法

#compound_query 的语法类似于 #ask,但包含多个查询,并且每个子查询的元素由分号分隔,而不是管道符。所有子查询共有的元素,如 format=width=(对于地图),应放在所有子查询之后。

示例

一个对 #compound_query 的示例调用,它检索了传记及其主题以及小说及其作者,如下所示:

{{#compound_query:
  [[Category:Books]]
  [[Has genre::Biography]]
  ;?Covers subject=Subject
  |
  [[Category:Books]]
  [[Has genre::Fiction]]
  ;?Has author=Author
  |format=list
}}

有关更多信息,请参阅扩展的主页MediaWiki.org

贡献和支持

原作者:Yaron Koren(版本0.4.1)

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

测试

此扩展提供单元和集成测试,这些测试由一个持续集成平台运行,但也可以从扩展基本目录中使用 composer phpunit 执行。

许可证

GNU通用公共许可证,版本2或更高版本.