zot4rst 0.3.0

背景

Zotero是管理引文的有用工具。

zot4rst是pythondocutils包的扩展，用于 reStructuredText文档中的引用。

zot4rst是在linux下开发的，已经在windows上进行了测试，并且 应该在mac操作系统下运行。

安装

1. 安装Zotero。

2. 下载并安装zotxt:

   https://bitbucket.org/egh/zotxt/downloads/zotxt.xpi

3. 安装zot4rst:

   sudo python setup.py install
   

快速启动

请参见example/example.rst，以及生成的example/example.pdf 和example/example.html。引文语法与pandoc相同。

zot4rst自动将引文键（例如@doetitle2010）映射到 Zotero数据库中的条目。钥匙应该是这样的 @作者日期。所以，对于这个项目：

John Doe, “Article,” Journal of Generic Studies, 2006.

你可以使用：@doearticle2006。这应该很容易使用，但是 引用必须是明确的，如果存在 是具有相同作者、标题和年份的多个项目。我在找 以更好的方式处理这件事。

要在reStructuredText文档中包含Zotero引文，必须 使用捆绑的zrst2*脚本，这些脚本已被修改为 包括对zotero指令的支持。这些可执行文件是 使用上面的setup.py安装。目前，它们是：

• zrst2html
• zrst2odt
• zrst2pdf
• zrst2pseudoxml
• zrst2rst

斯芬克斯

要在sphinx中使用，只需将zot4rst.sphinx扩展添加到 conf.py文件：

extensions = ['zot4rst.sphinx']

鹈鹕

若要在pelican（3.1版或更高版本）中使用，请在 pelicanconf.py文件：

PLUGINS = [‘zot4rst.pelican_plugin’,]

详细信息

一些细节，没有特别的顺序。

注意zrst2rst将把您的引文转换为普通引文 重新构造不带zotero扩展名的文本文件。例如：

A citation group :xcite:`[see @item1 p. 34-35; also @item3 chap. 3]`.

将变成：

A citation group (see Doe 2005, p. 34–35; also Doe and Roe 2007,
chap. 3).

书目将得到全面扩展。这个可以用来 创建不使用zot4rst的rst文件。

如果使用脚注引用格式，zot4rst将插入脚注 为你。

但是，如果您也在同一文档中使用常规的自动编号脚注 部分或段落，顺序将错误。所以如果你想的话 这个，你需要把你的引文放在脚注里 明确地。例如：

Water is wet. [#]_ But there are those who dispute it. [#]_

.. [#] :xcite:`[See @item3]`.

.. [#] These people are wrong.