README

允许为 Wikibase 实体定义 RDF 映射的 Wikibase 扩展。

Professional.Wiki 创建并维护了 Wikibase RDF。我们提供 Wikibase 托管、Wikibase 开发和 Wikibase 咨询。

《Wikibase 利益相关者小组》构思并资助了该扩展。

使用方法
- REST API
安装
PHP 配置
开发
发布说明

使用方法

当扩展启用时，项目和属性页面将显示“映射到其他本体”部分。该部分位于“更多语言”和“陈述”部分之间。

具有编辑权限的用户可以添加、编辑或删除映射。

映射由谓词和 URL 组成。谓词只能是预配置值集中的一项。URL 必须是有效的 URL。

映射谓词可以通过具有界面管理员权限的人通过 MediaWiki:MappingPredicates 页面进行配置。您也可以通过 PHP 配置配置映射谓词。

REST API

此扩展提供了用于获取和设置 Wikibase 实体 RDF 映射的 REST API 端点。

有关更多信息，请参阅 REST API 文档。

安装

平台要求

PHP 8.0 或更高版本（测试至 8.1）
MediaWiki 1.37 或更高版本（测试至 1.37）
Wikibase 1.37 或更高版本（测试至 1.37）

安装 Wikibase RDF 的推荐方法是使用 Composer 与 MediaWiki 内置的 Composer 支持。

在命令行中，进入您维基根目录。然后运行以下两个命令

COMPOSER=composer.local.json composer require --no-update professional-wiki/wikibase-rdf:~1.0

composer update professional-wiki/wikibase-rdf --no-dev -o

然后通过在您的维基的 LocalSettings.php 文件底部添加以下内容来启用扩展

wfLoadExtension( 'WikibaseRDF' );

您可以通过在浏览器中打开您的维基 Special:Version 页面来验证扩展是否已成功启用。

PHP 配置

配置可以通过 LocalSettings.php 进行更改。

允许的谓词

允许谓词列表。

变量: $wgWikibaseRdfPredicates

默认: []

示例

$wgWikibaseRdfPredicates = [
	'owl:sameAs',
	'owl:SymmetricProperty',
	'rdfs:subClassOf',
	'rdfs:subPropertyOf',
];

您也可以通过 MediaWiki:MappingPredicates 页面配置允许的谓词。

开发

要确保安装开发依赖项，请确保您的 composer.local.json 中包含以下内容

{
	"require": {
		"vimeo/psalm": "^4",
		"phpstan/phpstan": "^1.4.9"
	},
	"extra": {
		"merge-plugin": {
			"include": [
				"extensions/WikibaseRDF/composer.json"
			]
		}
	}
}

运行测试和 CI 检查

您可以通过在 WikibaseRDF 目录下运行 make 命令来使用 Makefile。

make ci：运行所有操作
make test：运行所有测试
make cs：运行所有样式检查和静态分析

或者，您可以从 MediaWiki 根目录执行命令

PHPUnit：php tests/phpunit/phpunit.php -c extensions/WikibaseRDF/
样式检查：vendor/bin/phpcs -p -s --standard=extensions/WikibaseRDF/phpcs.xml
PHPStan：vendor/bin/phpstan analyse --configuration=extensions/WikibaseRDF/phpstan.neon --memory-limit=2G
Psalm：php vendor/bin/psalm --config=extensions/WikibaseRDF/psalm.xml

发布说明

版本 1.1.0 - 2022-11-25

添加了各种语言的翻译
添加了关于 SPARQL 存储行为的提示，该提示在首次编辑时显示

版本 1.0.0 - 2022-10-04

这些功能的初始版本发布于 Wikibase 1.37

通过页面 UI 添加到项目和属性上的映射功能
将映射包含在 RDF 输出中
可配置的关系（谓词），包括在 MediaWiki:MappingPredicates 上的配置 UI
API 端点以检索或更新实体的映射
API 端点以检索在维基上定义的所有映射
TranslateWiki 集成
支持 PHP 8.0 和 8.1

专业维基 / wikibase-rdf

维护者

详细信息