README

publication-fetcher 是一个 composer 包，可以从多个来源导入出版物列表，例如 BibTex 文件、Google Scholar、EndNote 文件、PubMed 标识符和 DOI。

• 目录

入门

publication-fetcher 同时提供 API 和 CLI 来导入出版物。

安装

    composer require proximify/publication-fetcher

或创建一个项目

    composer create-project proximify/publication-fetcher

注意：如果您将 publication-fetcher 作为依赖项安装（即使用 require 选项安装），您需要手动创建二进制文件。为此，请转到 src 下的 C 文件夹并运行 "make" 命令。

API

publication-fetcher 从 bibtex、Google Scholar（bibtex）和 endnode 文件中导入。示例 bibtex 和 endnodes 文件可在 docs 文件夹中找到。

    use Proximify\PublicationFetcher\PublicationFetcher;
    
    $importer = new PublicationFetcher();
    $type = 'bibtex';
    $source = 'PATH_TO_FILE;
    $res = $importer->importPublications($type, $source);
    print_r($res);

它还可以从 PubMed 参考文献中获取出版物（即 PubMed 标识符）

    print('Importing from Pubmed:');
    $type = 'pubmed';
    $sources = [28375682, 20813019];

    foreach ($sources as $source)
    {   
        $res = $importer->importPublications($type, $source);
        print_r($res);
    }

和 DOI

    print('Importing from DOI:');
    $type = 'doi';
    $source = 'DOI: 10.1177/0741713611402046 DOI:10.18653/v1/P17-1152';
    $res = $importer->importPublications($type, $source);
    print_r($res);

测试

publication-fetcher 提供CLI、Web 界面和测试套件以进行测试。

CLI

    composer import-pubs

测试套件

    php dev/tests/Test.php

您还可以在 dev 文件夹下使用 Web 界面进行测试

    php -S localhost:8000 -t dev/www

注意：请设置 dev/www/api/index.php 和 dev/tests/Test.php 下 autoloader.php 的正确路径。否则，测试脚本将失败。

已知问题

Publication fetcher 组件是使用 UNIWeb 的出版物导入系统创建的，该系统包括如参考去重等特性。去重过程涉及到忽略用户简历中已有的参考文献。此类特性需要直接访问数据库，但此组件尚不支持。

未来工作

可能的工作之一是创建另一个组件（即出版物导入器），该组件同时使用出版物获取器和去重器组件，以防止导入数据库中目前存在的参考文献。

贡献

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

当您提交拉取请求时，我们将确定您是否需要提供 CLA，并相应地装饰 PR（例如，标签、注释）。只需遵循提供的说明即可。您只需在所有使用我们的 CLA 的仓库中这样做一次。

此项目已采用 Proximify 开源代码行为准则。有关更多信息，请参阅行为准则常见问题解答或联系 support@proximify.com 提出任何额外问题或评论。

许可证

版权（c）Proximify Inc。保留所有权利。

许可协议：MIT 协议。

publication-fetcher 由 Proximify 制作。我们邀请社区参与。