zot_bib_web

与Zotero的交互式网络书目

示例安装

宾夕法尼亚州实验室网站

个人网站

文档

http://zot-bib-web.readthedocs.io/

作者/联系人：

David [email protected] http://www.david-reitter.com

特征

该工具根据Zotero存储库中的一个或多个集合生成交互式Web参考书目。使用Zotero的Web界面或其桌面应用程序可以由人组维护收集。

书目可以按收集，出版年度或出版物类型（例如，首先搜索）订购，可以链接到PDF文档或其他URL，具有Bibtex，EndNote和Wikipedia的记录，并且可以将其导出到HTML或将其推向WordPress Database。

ZOT_BIB_WEB不依赖任何第三方Web服务器。生成的书目很快加载了，因为它们与您的网站的其余部分一起存储为静态文件。这是Webcrawlers的良好来源，包括Google Scholar和Citeseer。

对于运行自己的网站并知道如何使用命令行（Shell）的任何人来说，设置都很容易。使用它的最简单方法是用公共Zotero集合的键调用Zot.py。它将制作一个zotero-bib.html文件。将其与“站点”和“文件”（如果有）（如果有）目录一起复制到您的Web服务器。

演示

• 在演示文件夹中查看HTML文件，以获取一些书目示例。包括它们各自的设置文件和CSS样式文件。

• 跑步：

   ./zot.py- -sttings demo/settings3.py
  

  看到它在行动中。

许可和捐款

• 免费使用和修改此软件。
• 没有任何保修。
• 如果您决定使用zot_bib_web，请发送电子邮件至[email protected]您网站上参考书目的链接。
• 您可以免费使用此软件。

要求

• Python 2.7或3.6+

• Pyzotero。要安装Pyzotero，这是Python的库：

   sudo pip安装pyzotero
  

  或者：

   sudo easy_install pyzotero
  

• 带有参考书目的Zotero集合（作为用户或小组）

• 可选：Python的DateUtils包（如果存在的话，请改善日期解析）

设置

• 确保zot.py是可执行的（chmod ug+x zot.py）

• 尝试一下。从类似Unix的命令行中，执行此操作：

   ./zot.py-group 160464 dtdtv2ep
  

然后在浏览器中查看Zotero-bib.html。如果看起来不错，请继续进行配置。

• 在称为settings.py的新文件中，添加文件settings_example.py中记录的配置。转到Zotero.org获取API秘密密钥以及您的用户或库ID。很容易：有关详细信息，请参见设置的顶部。example.py。如果设置了设置，则可以在没有参数的情况下调用zot.py。

另外，您可以在程序中使用主设置。

Zotero的参考书目

• 使用Zotero，创建参考书目并记录其ID（例如，从Zotero Web界面中的URL）。示例： MGID90AT 。此ID是您在设置中的“ toplevelfilter”变量所需的。
• 您可以在书目中添加子收集。
• 如果您通过收款订购的格式，则给他们订单可能会有所帮助。您可以以一个数字开始命名：“ 10社会心理学”。

这是参考书目结构的一个例子：

我的出版物[mgid90at]
    10件作品
    15在准备 /正在审查中
    划定主题的20次裁判作品
        语义
        解析
        对话
        机器学习
    30篇论文
    40次谈判（没有纸）

要查看此内容，请以提供的设置为例。

配置选项的概述

• 配置发生在设置文件中，默认情况下命名settings.py。
• 呼叫./zot.py-----查看命令行选项的列表。
• 请参阅文档以获取有关设置文件的信息，或读取settings_example.py。以下讨论了一些选项。
• 您可以按子收集订购我们的书目，按年份或出版类型（例如，首先，期刊文章，然后是会议论文）。即使在高级类别中，您也可以根据需要对书目参数进行分类。使用“ sort_criteria”和“ show_top_section_headings”设置。
• 您可以选择其他格式约定。默认值为APA格式。
• 在顶部，可以显示一个搜索框和一组快捷方式：例如，几年或跨度的跨度，出版类型或指示主题领域的子汇编。访客可以单击这些以快速过滤参考书目。
• 使用Show_shortCuts变量配置顶部显示的快捷方式。 “收集”，“类型”，“ Year”，“ venue_short”和“ Tags”是受支持的值，除了可以使用快点（）函数创建的更细颗粒的值列表之外。您可以提供（多年）的值或范围列表，它们的顺序以及一些过滤，以显示最常见的列表。有关详细示例，请参见settings.example.py。
• 还有几个选择。同样，请参见settings_example.py。

部署到网站

• 将站点文件夹或其内容上传到您的Web服务器上的公共场所。默认情况下， /site /...是假定的URL。

生成HTML并将其包含在网站中：

• 每天运行zot.py一次/按需运行zot.py，或在服务器上以cron作业或服务安装每天不超过一次。直接在zot.py或单独的文件设置中配置它，以简单地组成升级。
• 如您所见，在网站中包含所得文件Zotero-bib.html（或作为配置）。您还可以包含也会生成的单个收集文件。您可以配置zot.py以生成完整的HTML文档，或者只是其中的一部分。 ZOT_BIB_WEB生成HTML5内容。
• 使用CSS设计书目。包括一个示例样式文件（请参阅站点/目录）。

WordPress支持

该软件包可以直接推到WordPress站点。为此，包括一个单独的程序“ push.py”。

请按照以下步骤：

1. 设置Zot.py以生成您喜欢的书目。致电zot.py-full以生成一个完整的zotero-bib.html文件以进行调试。配置settings.py不要生成完整的HTML代码。
2. 安装WPAutop-Control插件（或类似的插件），以确保WP不会在书目中的各个地方插入段落中断。使用此插件，您需要在下一步创建的页面（在页面视图的顶部选择“屏幕选项”，启用自定义字段。
3. 创建WP页面或参考书目的帖子。插入[zot_bib_web collection]您想要插入参考书目的位置。用集合的ID替换集合。 （更多选项：请参阅push.py）
4. 将样式表内容（在站点/中）复制到您的WordPress主题（选择“编辑器”或“额外CSS”）。
5. 配置settings.py，以便在Web服务器上可用jQuery和其他文件。通常，这将是jquery_path =“ ../wp-includes/js/jquery/jquery.js” clipboard.js and clippy.svg：您可以参考公共网址或自己服务文件。
6. 配置push.py（在顶部）。您将需要了解有关WP安装的一些简单详细信息。
7. 定期或按需运行push.py。它将自动调用zot.py，然后在WP中更新页面。