README

一个用于与使用ANSI C编写的Bibutils库交互的PHP类。 Bibutils 是由Chris Putnam 编写的C程序集。

"bibutils 程序集通过使用通用的 MODS 格式 XML 中间格式在不同参考文献格式之间进行相互转换。例如，可以通过进行两个转换：RIS->MODS->BibTeX，将RIS格式文件转换为BibTeX。通过使用N个格式的通用中间格式，只需要2N个程序，而不是N^2-N个。这些程序在命令行上运行，并模仿标准的类UNIX过滤器。"（见 CTAN软件包）

本项目使用的库的当前版本是 bibutils 6.10（发布于 2020-03-23）。原始文件未经修改，并按照 GNU通用公共许可证第2版进行分发。

Metadata Object Description Schema (MODS)

美国国会图书馆的 Metadata Object Description Schema (MODS) XML格式

"MODS 是一种XML架构和指南，用于编码资源描述。它支持资源的发现、管理和访问，以及编码描述的交换和管理。"（见设计原则）

安装

$ composer require proximify/bibutils
$ cd vendor/proximify/bibutils && composer build

类概览

namespace Proximify;

class Bibutils {
    public static read( array $options) : string
    public static convert( string $options) : string
}

`read`

public static Bibutils::read( array $options ) : string

描述

此方法将文件中的参考文献内容读取到MOD XML字符串中。当未明确给出时，输入是从文件扩展名推断出来的。

参数

返回值

加载的参考文献数据。在发生错误时抛出一个通用的异常。

`convert`

public Bibutils::convert( array $options ) : string

描述

此方法将文件中的参考文献内容读取到MOD XML字符串中，并将其转换为选定的输出参考文献格式。当未明确给出时，输入格式是从文件扩展名推断出来的。

参数

返回值

转换后的参考文献数据。在发生错误时抛出一个通用的异常。

示例

use Proximify\Bibutils;

// Read an EndNote XML into MOD XML
$xml = Bibutils::read(['filename' => 'dev/data/bibtex/one_of_each.bib']);

// Load a RIS file and converted into a BibTex string
$bib = Bibutils::convert(['filename' => 'refs.ris', 'out' => 'bib']);

CLI脚本

composer app:read dev/data/bibtex/one_of_each.bib
composer app:convert dev/data/bibtex/one_of_each.bib end

Bibutils参考

程序列表

下表来自 SourceForge文档

贡献

本项目欢迎贡献和建议。大多数贡献都需要您同意贡献者许可协议（CLA），声明您有权利并且确实授予我们使用您贡献的权利。有关详细信息，请访问我们的贡献者许可协议。

当您提交拉取请求时，我们将确定您是否需要提供CLA（贡献者许可协议）并对PR（Pull Request）进行适当的装饰（例如，标签、注释）。只需遵循提供的说明。您只需在整个使用我们CLA的仓库中这样做一次。

本项目采用了Proximify开源行为准则。如需更多信息，请查看行为准则常见问题解答或通过support@proximify.com与我们联系，提出任何额外的问题或评论。

许可

许可协议为MIT许可。请参阅许可文件以获取更多信息。

Bibutils (PHP包装器)由Proximify制作。我们邀请社区参与。

proximify / bibutils

维护者

详细信息