Pyzotero 技术文档

1. 安装指南

使用 pip 安装

在终端或命令提示符中，运行以下命令来安装 Pyzotero：

pip install pyzotero

使用 Anaconda 安装

如果你使用 Anaconda，可以运行以下命令来添加 conda-forge 通道并安装 Pyzotero：

conda config --add channels conda-forge
conda install pyzotero

从本地克隆安装

如果你希望从特定分支安装 Pyzotero，可以按照以下步骤操作：

1. 克隆 Pyzotero 仓库：

git clone git://github.com/urschrei/pyzotero.git

2. 切换到所需分支，例如 dev 分支：

cd pyzotero
git checkout dev

3. 使用 pip 安装：

pip install .

2. 项目使用说明

要使用 Pyzotero，你需要以下信息：

• 个人或群组图书馆的 ID
• API 密钥

个人图书馆的 ID 可以在 Zotero 设置中的“您的 API 用户 ID 用于 API 调用”部分找到。对于群组图书馆，打开群组页面，例如 https://www.zotero.org/groups/groupname，并悬停在“群组设置”链接上，ID 是 /groups/ 后面的整数。

获取 API 密钥，请访问 Zotero 设置并创建新的 API 密钥。

以下是使用 Pyzotero 的基本示例：

from pyzotero import zotero

# 替换以下变量为你的信息
library_id = '你的图书馆 ID'
library_type = 'user'  # 或 'group'
api_key = '你的 API 密钥'

zot = zotero.Zotero(library_id, library_type, api_key)
items = zot.top(limit=5)

# 打印每个项目的类型和 ID
for item in items:
    print('项目类型：%s | 项目 ID：%s' % (item['data']['itemType'], item['data']['key']))

3. 项目 API 使用文档

Pyzotero 的完整 API 方法、代码示例和输出样例可以在 Read The Docs 上找到。

4. 项目安装方式

项目的安装方式已在“安装指南”部分详细说明，包括使用 pip、Anaconda 和从本地克隆安装的方法。请参考上文中的步骤进行安装。