**Zotero Reference 用户技术手册**

Zotero Reference 用户技术手册

zotero-reference PDF references add-on for Zotero. 项目地址: https://gitcode.com/gh_mirrors/zo/zotero-reference

---

安装指南

1. 获取插件: 访问项目的最新发布页面下载最新的插件安装文件(.xpi)。
2. Zotero环境准备: 确保您的电脑已安装最新版本的Zotero。
3. 安装插件: 打开Zotero, 然后前往“工具”>“插件”。点击右上角的齿轮图标，选择“从文件安装”，浏览并选择之前下载的.xpi文件，确认安装即可。

---

项目的使用说明

初始配置与偏好设置

首次使用，强烈建议进入Zotero的插件偏好设置，调整至最适合您的配置。其中可自定义的数据源优先级、是否自动抓取参考文献等功能，有助于提升用户体验。

浮动窗口操作

• 数据源切换: 浮窗顶部的小圆点指示当前使用的数据源(PDF、readpaper、crossref等)，点击可在不同源间切换。
• 刷新参考文献: 单击图标，根据偏好从首选源获取文献信息；长按或使用快捷方式进行特殊操作，如重新解析或从特定位置开始解析PDF。
• 引用操作: 单击、长按引用条目实现复制、编辑或关联到Zotero图书馆的不同行为。
• 翻译功能: 必须预先安装zotero-pdf-translate插件，通过Ctrl+点击可在原文与译文间切换。

高级特性

• 分栏快速跳转: 对于含有内部链接的PDF，支持跳转到图表、公式等，通过设置可启用或禁用此功能。
• 推荐关联: 利用readcube API提供的功能，为文献推荐相关联的文献，增强研究深度。

设置界面详解

• 自动化选项允许控制文献自动抓取的行为。
• 排除某些条目类型以优化性能，例如排除不适合频繁刷新的长篇学位论文。
• 控制刷新时首先尝试的数据源。
• 开启控制台以查看插件日志，便于调试。

---

项目API使用文档

虽然直接调用插件内的API不是普通用户的常规操作，但开发者或高级用户可能对此感兴趣。插件利用了多个外部API，如unpaywall、crossref、readpaper和readcube，来实现数据检索和翻译等功能。具体API请求的详细文档，请查阅各自官方网站：

• unpaywall API 文档
• Crossref REST API 文档
• [readpaper.com 的服务虽未直接提供API文档，但其服务可用于插件通过网页接口间接调用]
• [readcube API 功能，虽提及但未直接提供API细节，推测插件内嵌调用]

对于开发者，了解这些API的工作原理和使用规范，可以帮助你更好地扩展或定制插件功能。

---

项目安装方式 (重复内容，已在安装指南中阐述)

请参照安装指南部分执行安装步骤。

---

这篇技术文档旨在引导您顺利安装与使用Zotero Reference插件，享受高效的文献管理和引用过程。如有更多疑问，可参考插件在GitHub上的讨论区或提交新的Issue。

zotero-reference PDF references add-on for Zotero. 项目地址: https://gitcode.com/gh_mirrors/zo/zotero-reference