README

语义引用（也称为SCI）是一个语义媒体Wiki扩展，它通过语义注解提供了一种简单的方式来组织引用资源。

它可以用于集中管理引用资源并促进wiki中存储的引用的重复使用。支持的功能包括

自定义引用列表
单个属性注解和文本格式化规则
文本引用提示
Bibtex记录导入支持
从所选提供商（PubMed，CrossRef等）检索元数据

一些视频展示了“如何使用语义引用或预期其工作方式”。

需求

PHP 7.4或更高版本
MediaWiki 1.35或更高版本
语义媒体Wiki 3.0或更高版本

语义引用不要求也不使用任何扩展Cite（或<ref>标签）作为声明引用资源的方式。

安装

推荐安装语义引用的方式是使用Composer，利用MediaWiki的内置Composer支持。

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

步骤1

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

{
	"require": {
		"mediawiki/semantic-cite": "~3.0"
	}
}

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

"mediawiki/semantic-cite": "~3.0"

请记住，在这个部分的上一行末尾添加一个逗号。

步骤2

在您的shell中运行以下命令

php composer.phar update --no-dev

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

步骤3

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

wfLoadExtension( 'SemanticCite' );

步骤4

运行维护脚本"update.php"以确保属性表正确初始化。

用法

引用资源收集了引用的所有结构化数据，这些数据在wiki中通过一个唯一的键访问，并由#scite解析器函数创建和管理。

引用资源（由#scite创建）可以添加到源页面或任何其他wiki页面，每个页面都有一个可识别的引用键。

{{#scite:Byrne 2008
 |type=journal
 |author=Byrne, A
 |year=2008
 |title=Web 2.0 strategies in libraries and information services
 |journal=The Australian Library Journal
 |volume=57
 |number=4
 |pages=365-376
}}

上面的例子展示了由#scite解析器创建的引用资源的示例。有关#scite的更多信息，请点击此处。

文本引用

可以使用引用引用（或其别名CiteRef）属性，以Lorem ipsum [[CiteRef::Byrne 2008]] ...的形式在文中进行注释，使其显示为Lorem ipsum^[1] ...。

一旦在页面上添加了引用引用注释，就会自动在内容中添加引用列表。可以使用魔法词__NOREFERENCELIST__来抑制在单个页面上显示引用列表，而#referencelist可以用来改变列表的位置。

有关文中引用和参考文献的更多信息，请参阅此处，以及有关#referencelist解析函数用法的描述#referencelist。

有关Semantic Cite和Cite的问题，请参阅评论部分。

元数据搜索

Special:FindCitableMetadata提供用户界面以搜索、查找和映射元数据，与#scite解析器一起使用，可以方便地将PubMed或CrossRef等来源的权威数据集成。

有关更多信息，请阅读搜索部分。

配置

要更改默认设置或添加属性映射、文本格式化规则，请阅读配置文档。

贡献和支持

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

测试

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

许可

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

mediawiki / semantic-cite

维护者

详细信息

README

需求

安装

步骤1

步骤2

步骤3

步骤4

用法

文本引用

元数据搜索

配置

贡献和支持

测试

许可