> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/latex/zh-cn/zhi-shi-ku/073-how-to-link-zotero-to-your-overleaf-account.md).

# 如何将 Zotero 链接到你的 Overleaf 账户

## 引言

本文将介绍如何将 Zotero 关联到您的 Overleaf 账户并使用它来 [向您的项目添加参考文献](#how-to-add-references-to-your-overleaf-project-using-zotero).

参考文献管理器集成是一项 [高级功能](/latex/zh-cn/zhi-shi-ku/120-overleaf-premium-features.md)。Overleaf 高级功能可供 Overleaf Commons 的参与者、组订阅成员以及个人订阅拥有者使用。

**注意**：如果您没有付费的 Overleaf 订阅，您始终可以导出 `.bib` Zotero 或其他文献管理软件中的数据，并将生成的 `.bib` 文件上传到您的 Overleaf 项目中。

## 如何将 Zotero 关联到您的 Overleaf 账户

1. 选择 **账户** 然后 **账户设置** 从下拉菜单中：

![显示如何访问 Overleaf 账户设置的图片](/files/cd9996cfd41b7313aa12b6ce15a3f5baec984678)

3. 将账户设置列表向下滚动到 **文献管理器** 部分，然后选择 **关联** 用于 **Zotero 集成**.

![显示将 Zotero 关联到您的 Overleaf 账户的账户设置图片](/files/88438a8caba435e3b06298f46123a9952b68e247)

如果您尚未登录 Zotero，系统会提示您登录 Zotero 账户。

1. 如果您已 *不* 登录 Zotero，请继续登录。
2. 您将看到 **新密钥** 界面：

![Zotero 在将其关联到您的 Overleaf 账户时显示的新密钥界面](/files/ce2942dfe1446d09ead0f4ca13428b6c7a4429ea)

3. 选择 **接受默认设置** 即可完成将 Zotero 关联到您的 Overleaf 账户的过程。
4. 如果您 *已* 已登录 Zotero。
5. 选择 **关联** 用于 **Zotero 集成** 可直接带您前往上面显示的 **新密钥** 界面。
6. 选择 **接受默认设置** 即可完成将 Zotero 关联到您的 Overleaf 账户的过程。
7. 成功关联 Zotero 后，您的 Overleaf 账户设置将会更新，以确认您的 Zotero 账户已关联到您的 Overleaf 账户。请注意，您可以随时解除关联您的 Zotero 账户。

![显示如何将 Zotero 从您的 Overleaf 账户解除关联的图片](/files/6ba8849e65f4bddfd7309f046be20b588264b020)

## 如何使用 Zotero 向您的 Overleaf 项目添加参考文献

将 Zotero 关联到您的 Overleaf 账户后，您可以通过两种方式向项目添加参考文献。

1. 您可以导入 Zotero 的 我的文库 或单个组文库，以创建一个 *只读* （不可编辑） `.bib` 文件，该文件可与您的 Zotero 账户同步。如果您在 Zotero 中更新参考数据，可以指示 Overleaf 更新（刷新）该 `.bib` 文件，使其与 Zotero 中所做的更改同步。请观看下面的 [视频](#a-video-to-demonstrate-importing-zotero-references-into-an-overleaf-project) ，了解从 Zotero 导入参考文献的演示。
2. 您还可以通过以下方式从 Zotero 账户导入单个参考文献： [配置 **高级参考文献搜索**](/latex/zh-cn/zhi-shi-ku/076-how-to-search-for-references-in-an-overleaf-project.md#configuring-advanced-reference-search-to-use-mendeley) 以在 Zotero 中查找参考文献。在 Zotero 中找到的任何参考文献，随后被引用时，都会添加到项目中包含的一个 *可编辑* `.bib` 文件中。

本文重点介绍选项 1， *批量导入* 参考文献以创建一个 *不可编辑* `.bib` 文件。要了解如何导入 *单个参考文献* 输入到 *可编辑* `.bib` 文件，请参见 [配置高级参考文献搜索以使用 Zotero。](/latex/zh-cn/zhi-shi-ku/076-how-to-search-for-references-in-an-overleaf-project.md#configuring-advanced-reference-search-to-use-mendeley)

### 将 Zotero 参考文献导入 Overleaf 项目

Overleaf 与 Zotero 的集成支持从 我的文库 和单个组文库导入参考文献，但您不能选择文库中的特定文件夹：特定 Zotero 文库中的所有参考文献，以及其中可能包含的任何文件夹，都会作为一个扁平列表被导入。

下面的视频演示如何从两个 Zotero 组文库导入参考文献，以创建两个新的 *只读* （不可编辑） `.bib` 这些文件： `articles.bib` 和 `books.bib`.

#### 演示将 Zotero 参考文献导入 Overleaf 项目的视频

下面的视频使用了 Zotero 中列出的两个预先准备好的组文库：

* TeX/LaTeX 文章
* TeX/LaTeX 书籍

如下图所示，并附有 Overleaf 中显示的对应下拉列表：

![显示 Zotero 和 Overleaf 中组文库的图片](/files/5fff35058ac528ea06e15d49a50d8252c57ea094)

{% embed url="<https://videos.ctfassets.net/nrgyaltdicpt/1w7rJCiRDEnuc75Wm7Rxgy/0fd01a899ca963704b7114f563104703/Zotero.mp4>" %}

## 关于 Overleaf 与参考文献管理器集成的说明

Overleaf 与外部参考文献管理器的集成依赖于各平台基于网页的 API（应用程序编程接口）所提供的功能和数据。目前，Overleaf 无法控制或修改这些 API 生成的输出，我们也不会对接收到的数据进行任何转换。 `.bib` 添加到您的 Overleaf 项目的 .bib 文件中的参考数据是 API 所提供内容的直接副本，以“按原样提供”的方式纳入 `.bib` 文件中使用的

### 引用键

对于给定的一组参考文献， `.bib` 参考文献管理器平台 API 生成的数据可能与通过该参考文献管理器提供的其他工具或服务导出相同参考文献所生成的数据不同。如果您在使用 Overleaf 的网页导入与手动上传 `.bib` 从参考文献管理器对应的桌面软件或在线文库中手动导出的 .bib 文件之间切换，这可能会引发问题。例如，如果您通过 Overleaf 的集成使用 Zotero 的网页 API 创建了一个 `.bib` 文件，随后又上传一个 `.bib` 通过直接导出流程创建的文件替换它，您可能需要检查生成的引用键是否存在差异，这些差异可能会导致先前可用的引用失效。

### 更新由参考文献管理器生成的项目 .bib 文件

包括 Zotero 在内的参考文献管理器提供两种方式来创建 `.bib` 项目中的文件。

1. 一个 *批量导入* 整个参考文献库，或者其某个参考文献组。
   * 这种方法会将 *只读* （不可编辑） `.bib` 文件添加到您的 Overleaf 项目中。对只读 `.bib` 文件所做的任何更改或更新，都必须在参考文献管理器中完成，并通过选择 **刷新** 按钮在文件预览顶部将其传输到 Overleaf。导入的 `.bib` 文件的刷新演示见上方 [视频](#a-video-to-demonstrate-importing-zotero-references-into-an-overleaf-project).
2. 从参考文献管理器导入 *单个参考文献* 使用 [**高级参考文献搜索**](/latex/zh-cn/zhi-shi-ku/076-how-to-search-for-references-in-an-overleaf-project.md#how-to-use-advanced-reference-search-premium-feature).
   * 添加到项目中的参考文献 `.bib` 文件使用 **高级参考文献搜索** 仍然完全可编辑。

### 关于权限的说明

有时，您可能会看到以下错误消息——例如，在将 Zotero 关联到您的 Overleaf 账户之后，又使用 Zotero 更改现有组的权限，或添加了 Overleaf 没有访问权限的新组：

![显示 Overleaf 提示权限错误消息的图片](/files/673599912057405b1923fb370e32ebd47cbb6654)

正如错误消息所述，请选择按钮 **重新关联您的账户** 以重新建立 Overleaf 访问您 Zotero 组中参考文献所需的权限。

## 进一步阅读

* [如何将 Mendeley 关联到您的 Overleaf 账户](/latex/zh-cn/zhi-shi-ku/070-how-to-link-mendeley-to-your-overleaf-account.md)
* [如何在 Overleaf 项目中搜索参考文献](/latex/zh-cn/zhi-shi-ku/076-how-to-search-for-references-in-an-overleaf-project.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/latex/zh-cn/zhi-shi-ku/073-how-to-link-zotero-to-your-overleaf-account.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.