dnb / mediawiki-gnd
添加脚本以将 GND 项目导入 Wikibase 存储库
dev-master
2023-03-02 22:38 UTC
Requires
- php: >=7.4
- composer/installers: ^2|^1.0.1
- dnb/wikibase-converter: dev-master
- jeroen/file-fetcher: ^6|^5|^4.2
This package is auto-updated.
Last update: 2024-08-30 01:39:36 UTC
README
MediaWiki 扩展,该扩展添加脚本以将 GND PICA+ 导入 Wikibase。
GND 扩展由 Professional.Wiki 为 德国国家图书馆 创建。 Professional.Wiki 提供 Wikibase 主机、MediaWiki 开发和支持的商用服务。
平台要求
- PHP 7.4 或更高版本,包括 PHP 8
- MediaWiki 1.35
- Wikibase Repository REL1_35
有关此扩展的不同版本的更多信息,请参阅 发布说明。
安装
首先安装 MediaWiki 和 Wikibase 存储库。
安装 GND 扩展的推荐方法是使用 Composer,利用 MediaWiki 内置的 Composer 支持。
在命令行中,进入您的维基根目录。然后运行以下两个命令
COMPOSER=composer.local.json composer require --no-update dnb/mediawiki-gnd:*
composer update dnb/mediawiki-gnd --no-dev -o
启用扩展
然后通过向您的维基的 LocalSettings.php
文件底部添加以下内容来启用扩展
wfLoadExtension( 'GND' );
您可以通过在浏览器中打开您的维基的 Special:Version 页面来验证扩展是否成功启用。
用法:GND doku function
{{#gnd_doku:language=en|codings=PICA3, PICA+}}
参数
language
。可选的语言代码。默认de
。支持en
和de
。codings
。可选。要显示的编码列。默认PICA3, PICA+, MARC21
。支持这 3 个值。
用法:GND import
通过 ImportGndDump.php
导入 GND。示例
php extensions/GND/maintenance/ImportGndDump.php --path extensions/GND/data/GND.json --limit 10
导入脚本期望每行有一个 JSON 结构的文件。有效文件的示例:https://github.com/ProfessionalWiki/GND/blob/master/tests/GND.json
要查看所有可用选项,请运行
php extensions/GND/maintenance/ImportGndDump.php --help
GND 词汇同步
通过 SyncDokuVocabulary
进行 Doku-wiki 词汇同步。示例
php extensions/GND/maintenance/SyncDokuVocabulary.php
用法:将项目属性更改为字符串
以逗号分隔的列表中提供的属性 ID。空格无关紧要。
php extensions/GND/maintenance/ItemPropertiesToStrings.php --properties "P1, P2, P3"
运行测试和 CI 检查
您可以通过在 ExternalContent
目录中运行 make 命令来使用 Makefile
。
make ci
:运行一切make test
:运行所有测试make cs
:运行所有风格检查和静态分析
发布说明
版本 0.1.0
开发中
- 为 MediaWiki/Wikibase 1.35 的初始发布