Zotero 支持直接打开并批注 PDF，与内部的笔记、同步等功能深度集成。建议使用 Zotero 阅读器以获得最佳体验。

打开文献 PDF ​

在主界面中选中文献，双击或回车即可打开文献 PDF。默认以新标签页打开。

💡 要以单独窗口打开文献，请在打开文献时按住 shift，或在标签页的标题上右键->移动标签->移动到新窗口。

Zotero 会自动记忆打开的文献与当前阅读位置。在下一次打开 Zotero 或在其他设备上打开同一个文献时，将会保持当前阅读位置。

阅读器功能介绍 ​

界面区域 ​

• 左侧是预览栏，可预览缩略图 / 目录；
• 右侧是信息/笔记栏；
• 上方横条是工具栏，可在此缩放、移动页面，或使用高亮注释（alt+1）、文字注释（alt+2）、框选注释（alt+3）等，设置注释颜色（alt+4 切换）；
• 中央是阅读区域。

快捷键整理（针对 Zotero 7 进行测试）：

| 快捷键 | 功能 | |

这些是使用 Zotero for MS Office Word 插件的说明。

要在 WPS 中使用插件，请参见 在 WPS 中使用 Zotero Word 插件。

Zotero Word 插件选项卡 ​

一般情况下，Zotero 安装时会安装 Zotero Word 插件，其会在 Microsoft Word 里添加一个 Zotero 选项卡。如果你的 Word 里没有 Zotero 选项卡，请参见 故障排除 | 安装 Zotero 的 Word 插件 。

Zotero 选项卡包含以下图标：

| 名称 | 图标 | 描述 | |

Zotero Attanger 是一款专为 Zotero 7 设计的附件管理插件，旨在替代不再支持 Zotero 7 的 ZotFile 插件。它提供了更强大的附件管理功能，支持多设备同步和自定义规则，适合需要定制化管理文献附件的用户。

主要作者：Rintze M. Zelle, PhD、 Brenton M. Wiernik、Frank G. Bennett, Jr.、 Bruce D’Arcus、Denis Maier

其他贡献者：Julien Gonzalez、Sebastian Karcher、Sylvester Keil、Cormac Relf、Lars Willighagen and other CSL contributors.

译者：Mao Zhou、 Northword、jiaojiaodubai。

此工作以  Creative Commons Attribution-ShareAlike 4.0 International License 授权。

介绍 ​

引注样式语言（Citation Style Language，CSL）是一种基于 XML 的格式，用于描述引注、注释和参考文献表的格式，它带来了：

• 一种开放（开源）的格式
• 紧凑、稳定的样式
• 对样式需求的广泛支持
• 样式的自动本地化
• 对样式发布和更新的基本支持
• 数千种免费提供的样式（CC BY-SA 授权）

更多文档，如 CSL 纲要、样式和本地化，请访问 CSL 项目主页。

术语 ​

本文涉及的情态动词 MUST、MUST NOT、REQUIRED、SHALL、SHALL NOT、SHOULD、SHOULD NOT、RECOMMENDED、MAY 和 OPTIONAL 的含义按照 IETF RFC 2119 中的描述来理解。

命名空间 ​

CSL XML 命名空间的 URI 是 http://purl.org/net/xbiblio/csl。

当提及 CSL 元素时，本规范始终使用 cs: 作为命名空间前缀，但根元素 cs:style 或 cs:locale 则通常省略前缀，因为它们已经有（使用 xlsns 属性设置的）默认命名空间声明。

空格处理 ​

CSL 样式是有效的 XML，但是对于那些旨在输出文本的属性，CSL 处理器不会通过修剪这些属性值前后的空格来满足规范化：

• after-collapse-delimiter
• cite-group-delimiter
• delimiter
• initialize-with
• name-delimiter
• names-delimiter
• prefix
• range-delimiter
• sort-separator
• suffix
• year-suffix-delimiter
• value

文件类型 ​

有 3 种 CSL 文件：独立样式和从属样式（都使用 .csl 作为扩展名），以及本地化文件（名为 locales-xx-XX.xml，其中 xx-XX 表示语言及其方言，例如 en-US 表示美式英语）。

独立样式 ​

独立样式包含了对引注、注释以及参考文献表的格式指令。虽然它们大多数都是自成一体的（即不依赖其他样式），但是区域化数据（默认）依赖于本地化文件。

从属样式 ​

从属样式是独立样式的别名（alias），其内容仅限于样式元数据，不包括任何格式指令（唯一的例外是：从属样式可以重新指定样式区域）。

一些期刊（例如《Nature Biotechnology》、《Nature Nanotechnology》）具有相同引用格式，通过将这些期刊的从属样式链接到一个单独的独立样式（例如《Nature Journals》），就无需再重复同样的格式指令。

本地化文件 ​

每个本地化文件包含一系列对某种特定方言的本地化数据（术语翻译、本地化日期格式以及语法选项）。

XML 声明 ​

每个样式或者本地化文件应该以 XML 声明开头，指定具体的 XML 版本以及字符编码。多数情况下，XML 声明可以是：

<?xml version="1.0" encoding="UTF-8"?>

样式的结构 ​

根元素—— cs:style ​

样式的根元素是 cs:style。在 独立样式 中，根元素有以下几种属性：

class ​

决定样式的 引注格式 是 in-text 风格（值 in-text）还是 note 风格（值 note）。

default-locale（可选） ​

为样式的本地化设值默认的地区。取值必须是 语言 - 地区代码。

version ​

样式的 CSL 版本。对于兼容 CSL 1.0 的样式，其值必须设置为 1.0。

此外，cs:style 可以携带任意的 全局选项 和 可继承的名称选项 。

在这些属性中，只有 version 对于 从属样式 内的 cs:style 是必须的，而 default-locale 属性则可以用来设置样式的地区。cs:style 还有其他属性可以设置，但此处先省略。

下面是一个 独立样式 的 cs:style 示例，其位于 XML 声明之后：

<?xml version="1.0" encoding="UTF-8"?>
<style xmlns="http://purl.org/net/xbiblio/csl" version="1.0" class="in-text" default-locale="fr-FR"/>

cs:style 的子元素 ​

在 独立样式 中，cs:style 有以下子元素：

cs:info ​

必须作为 cs:style 的第一个子元素出现。用以容纳样式的元数据（样式的名称、样式 ID、作者等）。

cs:citation ​

必须出现一次。用于描述 in-text 引注或者 notes 的格式。

cs:bibliography（可选） ​

可能会出现一次。描述参考文献表的格式。

cs:macro（可选）

可能出现多次。宏使格式指令得以重复使用，令样式更加紧凑和易于维护。

cs:locale（可选）

可能出现多次。用于指定（重写）本地化数据。

在 从属样式 中，cs:style 只有一个子元素，即 cs:info。

样式信息（Info） ​

cs:info 包含了样式的元数据。其结构基于 Atom Syndication Format。

在独立样式中，cs:info 有下面的几个子元素：

cs:author 和 cs:contributor（可选） ​

cs:author 和 cs:contributor 分别用来致谢样式的作者和贡献者，可能被使用多次。使用这两个元素时，子元素 cs:name 必须出现一次，而 cs:email 和 cs:uri 和可能各出现一次。这些子元素应当分别包含作者或贡献者的姓名、电子邮箱和 URL。

cs:category（可选） ​

样式可以分配到一个或者多个类别。通过将 citation-format 属性设为以下的值的其中之一，cs:category 可以被使用一次，用于描述如何渲染正文中的引注

• author-date - 如「… (Doe, 1999)」
• author - 如「… (Doe)」
• numeric - 如「… [1]」
• label - 如「… [doe99]」
• note - 引注将以脚注或尾注的形式出现。

cs:categroy 也可以在携带 field 属性时被多次使用，用来对学科进行分类（见 附录 I 学科分类）。

cs:id ​

必须出现一次，并且包含一个稳定、唯一的标识符来确定样式的身份。出于历史原因，目前的样式可能使用 URI 作为 id，但新的样式应当使用 UUID 来保证稳定性和唯一性。

cs:issn/cs:essn/cs:issnl（可选） ​

cs:issn 元素可以被多次使用，用来指出该样式所对应期刊的 ISSN 码。cs:eissn 和 cs:issnl 可以分别被使用一次，用来表示相应的 eISSN 和 ISSN-L 。

cs:link（可选） ​

可以被多次使用。cs:link 必须携带两个属性：href 用来设置 URI（通常情况下为 URL），rel 的值表示该 URI 与当前样式的关系。rel 可能的值为：

• self - 样式本身的 URI
• template - 当前样式源自某个模板，这是那个模板的 URI
• documentation - 样式说明文档的 URI

cs:published（可选） ​

可能出现一次。cs:published 的内容必须是一个 时间戳，用来表明样式创建的时间或者可获得的时间。

cs:rights（可选） ​

可能出现一次。cs:rights 的内容指定了该样式在哪一个版权协议下发布。这个元素可能会会携带一个 license 属性来明确协议的 URI。

cs:summary（可选） ​

可能出现一次。cs:summary 的内容给出了该样式的（简短）描述。

cs:title ​

必须出现一次。cs:title 的内容应当是该样式展示给用户的名称。

cs:title-short（可选） ​

可能出现一次。cs:title-short 的内容应当是样式名的简称（例如「APA」）。

cs:updated ​

必须出现一次。cs:updated 的内容是一个 时间戳，用来表示该样式最后更新的时间。

cs:link，cs:rights，cs:summary， cs:title 和 cs:title-short 元素可以携带 xml:lang 属性用来表示元素内容的语言（其值必须是一个 语言 - 地区代码）。对于 cs:link，该属性也可以用来表示链接目标的语言。

在从属样式中，独立父样式的 URI 时设置到 cs:link 的 href 属性时，cs:link 的 rel 属性必须设置为 independent-parent。此外，从属样式的 ref 不能设置为 template。

下面是一个独立样式的 cs:info 的例子：

<info>
  <title>Style Title</title>
  <id>http://www.zotero.org/styles/style-title</id>
  <link href="http://www.zotero.org/styles/style-title" rel="self"/>
  <author>
    <name>Author Name</name>
    <email>name@domain.com</email>
    <uri>http://www.domain.com/name</uri>
  </author>
  <category citation-format="author-date"/>
  <category field="zoology"/>
  <updated>2008-10-29T21:01:24+00:00</updated>
  <rights license="http://creativecommons.org/licenses/by-sa/3.0/">This work
  is licensed under a Creative Commons Attribution-Share Alike 3.0 Unported
  License</rights>
</info>

引注（Citation） ​

引注由一个或多个参考信息源的引用组成，cs:citation 元素描述了引注的格式。引注的形式可能是 in-text 风格（author 例如「Doe」、author-date例如「Doe 1999」、label 例如「doe99」，或者 number例如「1」）或者 notes 风格。必要的 cs:layout 子元素描述了引注中什么样的参考文献数据应该怎么被引用（见 Layout ）。在 cs:layout 之前可能会有 cs:sort 元素，它可以用来确定一个引注中的引用应该如何排序（见 排序）。此外，cs:style 可能携带任意的 引注选项 和 可继承的名称选项 中的属性。下面是一个 cs:citation 元素的例子：

<citation>
  <sort>
    <key variable="citation-number"/>
  </sort>
  <layout>
    <text variable="citation-number"/>
  </layout>
</citation>

CSL 处理器开发者注意

在 note 风格中，引注通常是一个自成一体的句子。因此，当注释前面没有内容时，引注的首字母最好大写。在其他情况下（例如，当一个引注被插入到一个已经存在的脚注的后面），引注应该保持原样输出。

参考文献表（Bioliography） ​

cs:bioliography 元素描述了参考文献表的格式，而参考文献表则列出了一个或多个参考信息源。必要的 cs:layout 子元素描述了每一个参考文献条目应当如何被格式化。cs:layout 之前可能会前置一个 cs:sort 元素，该元素可用于指定参考文献表内的参考文献应当如何被排序（见排序）。cs:bibliography 可能携带任意的 参考文献表选项 和 可继承名称选项 中的属性。下面是一个 cs:bioliography 的例子：

<bibliography>
  <sort>
    <key macro="author"/>
  </sort>
  <layout>
    <group delimiter=". ">
      <text macro="author"/>
      <text variable="title"/>
    </group>
  </layout>
</bibliography>

宏（Macro） ​

使用 cs:macro 元素定义的宏包含了格式化指令。宏可以被 cs:text 调用，而这个 cs:text 可能来自其他宏、cs:citation 和 cs:bioliography 内的 cs:layout 元素、位于 cs:citation 和 cs:bioliography 内的 cs:sort 的 cs:key。建议将宏放置在 cs:locale 元素之后以及 cs:citation 元素之前。

宏通过 cs:macro 的必要属性 name 的值来调用。cs:macro 必须包含一个或者多个 渲染元素。

使用宏可以提高样式的可读性、紧凑性和可维护性。建议通过过宏调用来实现 cs:citation 和 cs:bioliography 的内容的紧凑性以及某种条目类型（例如图书、期刊等）的定义。为了在其他样式中方便地复用宏，建议使用通用的宏名称。

下面是一个实例：引用中包含条目标题，当条目类型为 book 时，标题以意大利体渲染。

<style>
  <macro name="title">
    <choose>
      <if type="book">
        <text variable="title" font-style="italic"/>
      </if>
      <else>
        <text variable="title"/>
      </else>
    </choose>
  </macro>
  <citation>
    <layout>
      <text macro="title"/>
    </layout>
  </citation>
</style>

任何来自外层元素的分隔符都不会应用到 <text macro="..."> 元素的输出内（见 分隔符）。

本地化（Locale） ​

默认来自本地化文件「locales-xx-XX.xml」的本地化数据可以通过 cs:locale 元素重新定义或者补充定义。cs:locale 元素应该直接放在 cs:info 元素之后。

cs:locale 元素的可选属性 xml:lang 必须设置为 语言 - 地区代码，用于确定样式受哪种语言或方言影响（见地区回退）。

对于 cs:locale 元素的更多使用细节，另见 术语、本地化日期格式 和 本地化选项。

下面是一个 cs:locale 元素的例子：

<style>
  <locale xml:lang="en">
    <terms>
      <term name="editortranslator" form="short">
        <single>ed. &amp; trans.</single>
        <multiple>eds. &amp; trans.</multiple>
      </term>
    </terms>
  </locale>
</style>

地区回退 ​

本地化文件为语言方言提供了本地化数据（例如「en-US」代表美式英语），而样式中可选的 cs:locale 元素可以省略 xml:lang 属性，或者设置为某种语言（如「en」代表英语）或方言而具备这一属性。地区回退是一种用于确定从上述哪一个数据源（本地化文件或 cs:locale）中检索可本地化单元（日期格式、本地化选项或者术语的特定形式）的机制。

对于同一种语言的方言，其中一种被定义为主要方言，其他则都是次级方言。截至本文档编辑前，包含次级方言的本地化文件包括：

| 主要方言 | 次级方言 | |

CSL 是基于 XML 的，如果你不熟悉 XML，本章将带你了解编辑 CSL 样式及其本地化文件所需的 XML 基础知识。

标记语言 ​

「标记语言」是计算机领域中的概念，抛开晦涩的概念定义，我们的书面语言其实就是使用标记的语言。我们会用逗号、句号、感叹号等标点符号来标记句子的停顿和结束，用括号来标记补充信息，用引号来标记句子中引用的内容。在标点符号的帮助下，连续的信息变得富有层次，无声的字符也能表示丰富的语气。

在其他场景中，学生们使用不同颜色的荧光笔来标记文本的不同内容，语言学家们使用成分符号来标记句子的语法成分（如主语、谓语、宾语等），编辑们使用校对符号来标记对文本的修订行为（如删除、添加、替换等）……

标记语言将信息记录为结构化的文本，从而使得计算机能够识别和处理这些信息。

XML ​

XML（eXtensible Markup Language）是一种广泛使用的标记语言，结合下面的例子来看看 XML 的基本结构。

<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<!-- 这是一个注释 -->
<root>
  <child-one>
    <child-two attribute="属性" />
  </child-one>
  <child-tone />
</root>

下面，我们将逐行介绍这段代码。

1. 第一行称为声明，或者称为序言，总是在文档的最前面。包括了 XML 的版本、编码信息以及是否依赖外部文档等。实际编写 CSL 样式时，我们遵从的是同一套规则，只需从现有的样式文件中原封不动抄写这一行即可。
2. 第二行是 XML 文档的注释，格式为 <!-- 注释内容-->。注释的位置比较自由，但需要单独成行。你可以在某一段代码上方概括下一段代码的主要作用。
3. 剩下的代码为 XML 文件的主体部分，它由根元素及内部若干个子元素构成。

上面的代码中，最明显的是像「 <xxx>」这样的内容，它就是 XML 的「标签」。作为一种通用的标记语言，XML 中要表示许许多多的成分，标签就像注明了名称的括号，一方面像括号一样选定一段内容，另一方面又通过它的名称来指示这是一段什么内容。相比上一节 XML 基础 中的例子，读者在不知道标签具体定义的情况下仅凭标签名就能大致推测该标记的含义，而且使用命名来区分标记也使标记不再局限于有限的标点符号，提高了标记的可读性和拓展性。

元素就是被标签标记起来的一块内容，一个 XML 文档必需有一个唯一的根元素（如例子中的 root 元素），根元素包含其他所有元素。当然，其他元素内也可以有子元素。例子第一个 child-one 元素内有其他元素，因此它是一个「开放」的元素，以开始标签<child-one> 和 结束标签 </child-one>标记范围（正如括号那样需要成对使用）；而第二个 child-tone 元素没有子元素，因此它是一个「闭合」的元素，在同一个标签上开始和结束（正如逗号那样单独使用）。

属性写在标签名后，是对元素及其内容的描述，属性名和属性值之间用 = 隔开，属性值使用双引号 " 包裹。每个元素中，一个属性最多出现一次，一个属性只能有一个值。

值得注意的是，标签已经使用空格作为标签名和属性之间的分隔符，标签名和属性名中不允许使用空格（否则会引起歧义）。我们通常使用「烤串命名法」（kebab case）来命名标签名和属性名，即使用 - 来分隔一系列小写单词，如 child-one、attribute-one。

实体 ​

在上一节我们了解到，XML 文档是由声明、元素和注释组成的，大量使用了 < 和 > 等字符，为了避免歧义，在确实需要表达类似这样的字符时，需用名为「实体」的代码来代替。

| 所定义的实体 | 所代表的字符 | |

本文档旨在对于 Zotero 中文社区上发表文档的语言、版式、内容元素等方面提出可执行的要求，以便维持和改进文档的整体水平与可读性。

本文档未涉及的风格问题，应参考中文互联网一般实践，以及中文出版物的行业标准和国家标准；仍然不能得出结论的，可依兼顾严谨与开明的方针自行判断。

文件命名 ​

文档网站根据每个 Markdown 源文件的路径确定每个页面的路由。因而，确定文件名时应慎重，一旦确定，尽量不要再改动。 由于 Windows 不区分文件名大小写，故而 option-B.md 和 option-b.md 在 Windows 下会出现冲突。

我们使用的文件的命名规则是：

• 文件名一律采用小写字母
• 文件名应尽量使用单词全称，避免使用各种形式的简写
• 若文件名中含多个单词，应使用连字符 (hyphen) - 连接

文档 FrontMatter 规范 ​

通过 FrontMatter 为每个 Markdown 页面引入配置。

一般情况下，不需要手动配置 FrontMatter。

ZoteroPane ​

ZoteroPane 是 Zotero 中主界面项目视图的抽象。可用于获取选中的项目，等等。

源码位置：chrome/content/Zotero/zoteroPane.js

可通过 ZoteroPane.getSelectedItems() 获取选中的条目； 通过 ZoteroPane.itemsView.onSelect.addListener 添加条目选中事件监听。

ZoteroPane.selectItem(itemID); // 必须先切换到文库标签页

Zotero.Collections 与 Zotero.Collection ​

Collection（集合）是 Zotero 中所有条目的父层级，是 Library（库）的子层级。

• chrome\content\Zotero\xpcom\data\collection.js 定义了 Zotero.Collection 类
• chrome\content\Zotero\xpcom\data\collections.js 定义了 Zotero.Collections 对象，用于访问相关方法

Zotero.Libraries 与 Zotero.Library ​

Libray（库）是 Zotero 中所有条目最终的父层级。Zotero 库分为用户库（id=1）与群组库，库之间的内容存储方式可能具有较大不同。

• chrome\content\Zotero\xpcom\data\library.js 定义了 Zotero.Library 类
• chrome\content\Zotero\xpcom\data\librarys.js 定义了 Zotero.Libraries 方法，用于访问相关方法

Zotero.Reader ​

Zotero.Reader 是 PDF 阅读器的接口，但对于阅读器中诸如选中、高亮等许多功能在 viewer.html 内，无法直接从 Zotero 中调用，相关源码在 pdf-reader 仓库。本节仅作介绍 Zotero.Reader。

源码位置：chrome/content/Zotero/xpcom/reader.js

基本使用 ​

通过 Zotero.Reader._readers 访问当前的 ReaderInstance 对象，每个对象有 _iframeWindow 属性，可对其执行界面操作。

Zotero.Reader.getByTabID(Zotero_Tabs.selectedID);

const cont = document.getElementById(`${Zotero_Tabs.selectedID}-context`);
const box = cont.querySelector("tabbox");
box.tabs.append(tab);
box.tabpanels.append(panel);

调用 pdf.js 接口 ​

ReaderInstance 对象的 _iframeWindow 属性是阅读器的 window 对象，也就是在网页版所看到的内容，它包含了整个 pdf 阅读器的 document 对象与 wrappedJSObject 字段。

通过调用 ._iframeWindow.wrappedJSObject 可在阅读器命名空间外访问其局部变量，其中的方法有 zoteroCopyImage 和 zoteroSaveImageAs 等。同时他包含了 PDFViewerApplication 对象。

该部分源码在 pdf-reader/src at master · Zotero/pdf-reader

._iframeWindow.wrappedJSObject.PDFViewerApplication.pdfViewer.currentPageNumber

此外，通过注入脚本的方式可以直接访问 PDFViewerApplication 对象来操作阅读器：chartero | chrome/content/reader.js

案例 ​

1. 获取 pdf 指定页面所有文字 ​

以第一页为例，索引为 0：

const reader = Zotero.Reader.getByTabID(Zotero_Tabs.selectedID);
const PDFViewerApplication =
  reader._iframeWindow.wrappedJSObject.PDFViewerApplication;
await PDFViewerApplication.pdfLoadingTask.promise;
await PDFViewerApplication.pdfViewer.pagesPromise;
let pages = PDFViewerApplication.pdfViewer._pages;
let pdfPage = pages[0].pdfPage;
let items = (await pdfPage.getTextContent()).items;

这里以 item=items[0] 为例：

{
  chars: Array(63) [ {…}, {…}, {…}, … ]
	dir: "ltr"
	fontName: "g_d0_f1"
	height: 6.376
	str: "Ma, Z., Hu, X., Huang, L., Bi, J., Liu, Y., 2014."
	transform: [6.376, 0, 0, 6.376, 42.5197, 732.5289]
	width: 202.367864
}

这里的 item.chars 记录了 item.str 的每个字符对应的渲染信息。除了宽高外，item.transform 还提供了 (x=item.transform[4], y=item.transform[5]) 位置信息。这个位置以 pdf 页面左下角为原点。

根据 pdf 页面内的文字可以解析出所有参考文献，详见：GitHub - MuiseDestiny/Zotero-reference: Zotero 插件，侧边栏显示正在阅读文献的所有参考文献

Zotero.Notes ​

Zotero.EditorInstance 类是笔记编辑器的抽象；Zotero.EditorInstanceUtilities 对象包括了笔记中一些转换等基础功能。

源码位置：chrome/content/Zotero/xpcom/editorInstance.js

Zotero.Notes 是所有 EditorInstance 实例的管理器。

源码位置：chrome/content/Zotero/xpcom/data/notes.js

Zotero_Tabs ​

Zotero 6 以后的版本引入了标签页（tab）。当打开 PDF 时，默认在新标签页打开。 源码位置：chrome/content/Zotero/tabs.js

基本使用 ​

通过 Zotero_Tabs 访问当前打开的标签页。

新增标签页 ​

通过 Zotero_Tabs.add 方法新增标签页，例如 Better Notes 插件中的一段代码：

let { id, container } = Zotero_Tabs.add({
  type: "betternotes",
  title: Zotero.locale.includes("zh") ? "工作区" : "Workspace",
  index: 1,
  data: {},
  select: select,
  onClose: undefined,
});

请注意此处的 type 将影响菜单栏的显示/隐藏。截至文档更新（2022.08.22），在离开标签时，自定义的标签类型不会被正确隐藏，但在进入标签页时会被显示（相关代码在 ZoteroStandalone.switchMenuType）。因此需要手动处理离开标签页时隐藏自定义标签的部分菜单。

switchRealMenuBar(hidden: boolean) {
    // We only handle hide. The show will be handled by the ZoteroStandalone.switchMenuType
    document
      .querySelectorAll(".menu-type-betternotes")
      .forEach((el) => ((el as HTMLElement).hidden = hidden));

    // Disable Zotero pdf export
    (document.getElementById("menu_export_files") as XUL.Element).disabled =
      !hidden;
}

标签页操作 ​

通过 select / jump / move / close 等相关方法进行操作。

Zotero_Tabs.select("zotero-pane");

文件操作 ​

Clipboard API ​

Zotero 中关于剪切板的相关接口。由于 Zotero 目前基于 FireFox60，因此无法使用现代浏览器的剪切板接口。 样例代码为 Better Notes 插件提供的剪切板包装：

class CopyHelper {
  transferable: any;
  clipboardService: any;

  constructor() {
    this.transferable = Components.classes[
      "@mozilla.org/widget/transferable;1"
    ].createInstance(Components.interfaces.nsITransferable);
    this.clipboardService = Components.classes[
      "@mozilla.org/widget/clipboard;1"
    ].getService(Components.interfaces.nsIClipboard);
  }

  public addText(source: string, type: "text/html" | "text/unicode") {
    const str = Components.classes[
      "@mozilla.org/supports-string;1"
    ].createInstance(Components.interfaces.nsISupportsString);
    str.data = source;
    this.transferable.addDataFlavor(type);
    this.transferable.setTransferData(type, str, source.length * 2);
    return this;
  }

  // Only Windows
  public addImage(source: string) {
    const io = Components.classes[
      "@mozilla.org/network/io-service;1"
    ].getService(Components.interfaces.nsIIOService);
    const channel = io.newChannel(source, null, null);
    const input = channel.open();
    const imgTools = Components.classes[
      "@mozilla.org/image/tools;1"
    ].getService(Components.interfaces.imgITools);

    const buffer = NetUtil.readInputStreamToString(input, input.available());
    const container = imgTools.decodeImageFromBuffer(
      buffer,
      buffer.length,
      channel.contentType,
    );

    this.transferable.addDataFlavor(channel.contentType);
    this.transferable.setTransferData(channel.contentType, container, -1);
    return this;
  }

  public copy() {
    this.clipboardService.setData(
      this.transferable,
      null,
      Components.interfaces.nsIClipboard.kGlobalClipboard,
    );
  }
}

使用样例：

new CopyHelper()
  .addText(html, "text/html")
  .addText(this._Addon.parse.parseHTMLToMD(html), "text/unicode")
  .copy();

弹出通知 ​

const popMsg = new Zotero.ProgressWindow({ closeOnClick: false });
popMsg.changeHeadline("[Error]", "", "Chartero");
popMsg.addDescription("

本节描述了在 Zotero 中添加条目（例如书籍、期刊文章、网页等）的各种方法。要了解有关添加附件（例如 PDF 或图像）的更多信息，请参阅 添加附件 页面。

条目与附件 ​

在使用 Zotero 之前，我希望可以引入几个术语：

条目 Item ​

Zotero 的基本文件单元，用来表示一篇论文、一本书等的题录信息，引用时使用的条目中储存的信息。下面是一些常见的条目类别：

| 图标 | 类型 | | :

我们强烈建议您定期备份 Zotero 数据目录。虽然同步是确保您可以在计算机发生问题时恢复库的好方法，但它并不能完全替代正确的备份：Zotero 服务器仅存储库的最新版本，并且只需要一个（可能是自动）同步以更改服务器副本（尽管可以从 Zotero 的自动备份恢复一些无意的更改）。

在本页中，我们首先介绍 Zotero 运行所需的三类文件，然后介绍若干种备份这些文件的方式。

概述 ​

我们将构成 Zotero 正常运行的文件分为三部分：

• Zotero 程序文件 (Program Files)
• Zotero 数据文件 (Zotero Data Folder)
• Zotero 用户配置文件 (Zotero Profile Directory)

程序文件 ​

这些文件构成 Zotero 程序的主体，包含了 Zotero 程序的二进制文件（例如 zotero.exe 等）和相关的库文件，不包括您的数据和个性化设置。

这些文件由安装包释放，通常无需额外备份。

数据文件 ​

这个目录包含了 Zotero 存储的所有数据，包括您的文献条目信息、笔记、附件、标签、文件夹结构、转换器和引文样式等。这是最重要的部分，因为它包含了您的研究资料。备份数据文件可确保您不会失去已收集的所有信息。

数据文件位置 ​

除非您在 Zotero 设置的高级窗格中选择了自定义数据目录，否则您的 Zotero 数据将存储在以下与操作系统相关的目录中：

| 系统类型 | 默认位置 | |

各方式优缺点对比 ​

| 方式 | 优点 | 缺点 | 推荐度 | |

本文整理了一些关于校外访问文献资源的常见问题及解决方法。你可以在右侧大纲栏（部分窄屏设备也可能在顶部「页面导航」）或下面的目录快速定位到你需要的内容。

校外访问的基本概念 ​

校外访问是指在不连接校园网的情况下，通过特定工具或服务访问学校购买的文献资源。常见的校外访问方式包括：

• 数据库官方提供的外部访问：一些数据库提供的校外访问服务（如中国知网的高校/机构外部访问系统、ScienceDirect 的通过您的组织访问）。该方法通常不限制网络环境，需要学校统一认证登录的账号密码进行身份认证。
• 校外访问系统：学校提供的 VPN 或 WebVPN 服务。
  • VPN：通过客户端加密连接虚拟接入校内网络，全局代理所有流量，可访问所有内网资源（如数据库、教务系统），需下载客户端。
  • WebVPN：通过浏览器访问特定网页链接，仅代理浏览器内的网页请求，无需客户端但功能受限（仅支持部分资源且无法代理其他软件）。
• 学校镜像站：部分学校提供的文献数据库镜像站。

此外，还有一些其他的资源获取方式：

• 社会图书馆镜像站：部分社会图书馆提供的文献数据库镜像站，如浙江图书馆、国家图书馆等单位提供的镜像站。
• 第三方文献资源站：如 Unpaywall、Sci-Hub 等站点，提供免费获取文献的服务。
• 文献互助平台：如科研通等平台，用户可以在上面分享和请求文献。

解决校外访问抓取失败的问题 ​

更新 Zotero 的转换器 ​

确保 Zotero 的转换器为最新版本。详细操作请参考：更新抓取文献信息的转换器。

使用数据库官方提供的外部访问服务 ​

数据库官方提供的外部访问服务通常是最稳定的校外访问方式。该方法不会修改页面网址，无需转换器做特殊兼容，无需做特殊设置，且可在国外网络环境下使用。一般情况下，只要数据库官方支持通过你的学校/机构进行外部访问，就建议优先使用这一方式。

各个数据库的校外访问入口通常在数据库的登录页面中，也可能在文献的详情信息也上（通常会叫做 Log in via an institution、Institution Login、Institutional Sign In 等等）。以下整理了一些常见学术数据库的校外访问入口，供参考使用：

使用学校的 VPN ​

通过学校的 VPN 客户端连接校园网是较为的校外访问方式。该方法可以全局代理所有流量，以校园网环境访问所有内网资源（如数据库、教务系统），需要下载客户端，但不需要额外的配置。

使用学校的 WebVPN ​

如果通过学校的 WebVPN 访问数据库，实际访问的链接会变得与数据库官网的原始链接不同，很有可能导致 Zotero Connector 无法为该网站正确匹配到相应的转换器，最终只能抓到一个网页快照。

如果您需要使用学校的 WebVPN 访问数据库，请阅读下面的教程配置 Zotero Connector 选项中的「Proxies」。

本页面整理了一些 Zotero 同步相关的问题及解决方法，你可以在右侧大纲栏（部分窄屏设备也可能在顶部「页面导航」）或下面的目录快速定位到你需要的内容。

如果仍没有找到你需要的问题，可以考虑在 Zotero 中文社区提问咨询或前往 Zotero 官方论坛发帖求助。

准备工作：确定附件的存储类型 ​

最直接的判断方法是根据文库中的附件图标判断附件的类型。根据附件的类型，可以判断当前使用的同步方案是否存在问题。

• 存储的附件

  

  图标上没有小链条，表示该附件是存储的附件，由 Zotero 直接管理。需采用「WebDAV 同步方案」或「Zotero 官方存储空间」进行同步。

• 链接的附件

  

  图标上有小链条，表示该附件是链接的附件，Zotero 仅保存了一个指向该文件的链接，文件本身存储在其他位置。需采用「Attanger + 同步盘」方案进行同步。

• 如果您在使用 Attanger/ZotMoov + 同步盘方案时，发现 Zotero 中的附件图标上没有小链条，表示该附件不是链接的附件，未被移动到同步目录，无法被同步。请按照教程：迁移到 Attanger + 同步盘方案 处理。

问题排查 ​

请根据您使用的同步方案，在下面对应的章节排查常见问题。

本节是 https://www.zotero.org/support/preferences/hidden_preferences 的翻译版本。

您可以通过 Zotero 中的首选项窗口编辑大多数 Zotero 设置。但是，Zotero 和 Zotero 连接器都支持额外的隐藏首选项。这些设置可能接受的测试较少和/或旨在用于更高级的用途。

Zotero ​

要查看 Zotero 首选项的完整列表，包括许多隐藏的首选项，请转到 Zotero 首选项的高级窗格并单击「设置编辑器」。在出现的列表顶部的过滤器字段中输入「Zotero」。用户可以安全更改的首选项如下所述。 大多数 Zotero 隐藏首选项都以 extensions.zotero 开头。

通用设置 ​

这些通用隐藏设置允许您定制化 Zotero。

| 设置名称 | 默认值 | 描述 | |

首先需要明确的是，本插件适用人群：想美化自己的 Zotero，有一定学习插件的时间。

💡 强烈建议先按照文章顺序将整个教程完整的阅读一遍，了解插件的各个功能，再根据兴趣了解某个功能的详细设置/使用方法。

该插件有很多提升效率的功能，也有很多美化的功能，但也可能导致 Zotero 卡顿，在使用时应该根据自己的情况进行调整。

开始之前 ​

在使用插件之前，你需要知道 Style 的设置方式主要有两种。

列设置 ​

第一种，右键任意一个列的名字，会弹出一个右键菜单，并且在最后有两个按钮，一个是列设置，一个是视图组。前者是对应列的设置选项，后者是一个将列分组快速切换的功能，后续会提到。

例如：如果你想设置标签，你可以在标签上右键，然后点击列设置，这是一切设置的起点，你在不同列名上右键，对应的列设置功能不同。

命令框 ​

第二种，通过命令框修改设置。Style 命令框的快捷键是Shift + P，有时候也可能是Shift + Tab + P，许多功能通过此快捷键进行使用，如果显示不全时，可通过暂时禁用其他插件解决。

列 ​

标题（阅读进度条） ​

阅读进度直观地反映了您对某个项目下的 PDF 各页的阅读时间分布情况，颜色越深阅读时间越长。

阅读进度条显示在两个地方，其一是作为标题列的背景：

其二是在命令框。用选中要查看的这条文献，按 Shift + P，一个的命令窗口出现了。你可以点击「高能阅读进度条」,以查看你阅读的详细时间。鼠标点击进度条，还可以快速跳转到 PDF 对应页面。

标注（原进度） ​

它可以直观地表示某个项目对应的 PDF 每页的注释字数。

标签 ​

在 Zotero 6 上，Style 插件为标题列提供了一个选项，允许将标签在标题前显示，但 Style 十分鼓励打开本列显示标签，因为这种圆圆的标签十分好看，并且这一列经过像素级优化使得圆形和 Emoji 对齐（下图是对比）。

#标签 ​

它的功能很简单，标签列会渲染 Emoji，但一旦涉及到文字，就会渲染成一个圆。

#标签会显示你所输入的所有内容。但考虑到你的 Zotero 里已有海量标签，为了不让它显示所有标签，这里只会显示#开头的标签。

百度翻译和垂直领域翻译免费额度：

• 通用翻译：完成个人认证可升级使用高级版服务，提供基础文本翻译服务，支持自定义术语翻译功能。每月 100 万字符免费，QPS 为 10，单次最长请求 6000 字符，支持 28 个常见语种。
• 垂直领域翻译: 开通并认证后，即享每月 50 万免费字符。目前已开通学术论文、生物医药、信息技术、金融财经、机械制造、网络文学（仅支持中英）、新闻资讯、人文社科（仅支持中英）、航空航天、法律法规、合同共 11 个垂直领域。

以上接口，超出部分按 49 元/百万字符计费，垂直领域接口申请成功后的提示：高级版是每月 100W 字符。

1. 账号注册 ​

直接访问 https://fanyi-api.baidu.com/product/11，如果未登录，点击右上角登录。没百度账号的同学，就直接新注册一个。

网页上直接列出了通用文本翻译和领域翻译，这两个就是常说的百度翻译和百度垂直领域翻译。这两个的区别是：

• 免费额度不同，垂直领域相比通用文本翻译免费额度少，每月只有 50W
• 精细度不同。为了提升特定领域机器翻译的准确度，百度翻译针对多个垂直领域模型进行了优化，特定领域术语翻译相较于通用文本翻译 API 结果更为准确，句式更加符合该行业特点。

目前已开通科技电子、水利机械、生物医药等 3 个垂直领域，不过只有生物医药支持中英互译，剩下两个只支持中文到英文。建议生物医药相关专业的同学，可以试试使用垂直领域翻译接口。

访问 https://fanyi-api.baidu.com/product/11，直接点击下方立即使用：

点击之后可能出现验证（手机或实名制认证），请按照说明进行验证，提升免费额度。

然后需要注册成为百度翻译开发者，请选择个人开发者，并如实填下方表格中的信息。

选择下方高级版，每月 100W 免费额度。

2. 百度翻译（通用文本翻译）接口申请 ​

访问 https://fanyi-api.baidu.com/choose ，选择通用文本翻译，点下一步：

应用名称是必填的，其他随意写。最后点击提交申请。

上图是开通成功后的页面。

3. 百度垂直领域（领域翻译）接口申请 ​

打开这个网页 https://fanyi-api.baidu.com/choose，选择领域翻译，点下一步：

https://fanyi-api.baidu.com/api/trans/product/desktop?req=field 垂直领域的后台界面，上面有对应的使用明细。

4. 接口密钥查询 ​

打开 https://fanyi-api.baidu.com/api/trans/product/desktop，可以在最下面看到配置使用的 APP ID 和密钥。

垂直领域翻译还需要一个领域参数，具体领域信息如下：

| 支持传入值 | 描述 | 支持语言方向 | |

• 项目主页：https://github.com/windingwind/zotero-pdf-translate
• 下载地址：
  • GitHub Release
  • Zotero 中文社区插件商店

Zotero PDF Translate 是由 @windingwind 开发的，用于文献管理软件 Zotero 的翻译插件。它完全开源、免费，主要功能有：

• 划词翻译（自动/手动）
• 标题、摘要翻译与源文本/翻译结果显示切换
• 批注翻译（自动/手动）
• 支持 15+ 种翻译服务与 4+ 种字典服务
• 自定义翻译侧栏 UI，支持同时使用多种翻译引擎

插件深度集成了 Zotero 文献阅读功能。

国内常用翻译引擎 ​

我们收集整理了一些国内常用的翻译引擎，这些带密钥的翻译引擎，同知网，海词等相比，更加稳定，大批量和频繁使用时不容易出错。

| 引擎名称 | 免费额度 | 参考文档 | 备注 | |

Awesome GPT for Zotero 是一个由 MuiseDestiny 创建的开源 Zotero 插件。这个插件使得用户能够通过命令标签使用 Meet API，进一步增强 Zotero 与 GPT 模型（包括 gpt-3.5-turbo 和 gpt-4）的集成。

• 项目主页：https://github.com/MuiseDestiny/zotero-gpt
• 下载地址：插件商店 - Zotero 中文社区。
• 视频教程：Zotero GPT - 使用教程，配置免费密钥！！！

主要特点包括：

• ✅ 🔗 与 Zotero 集成：您可以使用该插件，根据所选文本或 PDF 文件搜索和查询资料库中的项目。
• ✅ 🧠 使用 GPT 生成回复文本：支持 gpt-3.5-turbo 和 gpt-4
• ✅ 🏷️ 命令标签：点击一次，加速研究。
• ✅ 💬 就当前 PDF 文件（全文或选定文本）提出问题。
• ✅ 💬 就所选论文（摘要）提问。
• ✅ 📝 将所选论文概括成几个高度浓缩的句子。
• ✅ 🔍 根据所选文本搜索图书馆中的项目。
• ✅ ⚙️ GPT 的高级设置：可以设置 api 密钥、型号名称、api 网址、温度。
• ✅ 与 Better Notes 集成：使用 Better Notes 时可直接打开此插件。

用户界面功能

• ✅ 🎨 实时标记回复文本：支持 LaTeX 和 MathJax。
• ✅ 🔍 放大或缩小回复文本或插件窗口的大小。
• ✅ 🖱️ 将插件窗口移动到屏幕上的任意位置。
• ✅ 将回复文本复制到剪贴板。
• ✅ ⚠️ 当请求失败时，将显示详细的错误信息。
• ✅ 🔧 与 Zotero 6 和 Zotero 7 兼容。

如何使用 Zotero GPT ​

基本操作 ​

| 动作 | 快捷键 | |

我们在这里把同步分为「数据的同步」和「文件的同步」。

数据的同步指 条目字段信息、批注、笔记 的同步，这些数据仅能通过 Zotero 官方提供的服务同步。

文件的同步指 PDF 附件、网页附件、Word 文档、EPub 文件 等所有附件的同步。这些文件既可以通过 Zotero 官方服务同步，也可以通过 WebDAV 网盘来同步。

数据的同步 ​

您可以在「Zotero」→「编辑」→「设置」→「同步」→「数据同步」中输入您的 Zotero 账户的用户名和密码，然后点击「启用同步」进行登录。

文件的同步 ​

常用的文件同步方式有：

• Zotero 官方存储空间：Zotero 官方提供的存储空间，300 MB 免费。
• WebDAV 同步：坚果云网盘、InfiniCLOUD 等支持 WebDAV 的网盘，部分服务商有免费的使用额度。
• 第三方同步盘：如 OneDrive、百度网盘、iCloud 等，结合 Attanger 等插件进行同步。

其中，Zotero 官方存储空间和 WebDAV 同步是官方推荐的同步方式，附件直接由 Zotero 进行管理，使用起来最为简单。第三方同步盘的方式则是通过 Attanger 等插件将附件转换为链接的附件进行同步，使用起来较为复杂，容易出现问题，且不支持 Zotero 官方的移动客户端。我们始终建议通过官方服务或 WebDAV 网盘进行附件同步。

Zotero 7 正式版已经发布，我们强烈建议绝大部分用户使用稳定的正式版 Zotero，而不是 Beta 版本。安装或升级 Zotero 7 正式版请阅读：你好，Zotero 7。

Zotero Beta 下载 ​

Zotero 的 Beta 版本是测试版，包含正在测试的新特性和新功能。Beta 版可能存在 Bug，运行可能不稳定，部分插件也没有及时适配最新的 Beta 版。

如果您确定要使用 Beta 版本，且具有较强的解决问题能力，能够接受可能出现的故障，我们建议您使用最新版本的 Zotero 7 Beta，以确保获得最佳体验和最新功能。下载最新的 Beta 版本请访问：Zotero Beta 下载页面。