> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Mendeley 集成

> 关联你的 Mendeley 账户，将文献库导入 .bib 文件，从中引用、刷新文件并取消关联。

将 Mendeley 文献库以 `.bib` 文件的形式导入项目，然后像平常一样从中引用。该文件是一份副本：只有在你点击 **Refresh** 时才会变化。

> [!NOTE]
>
> 如果你在 **Account settings** 中看不到 Mendeley 选项，请让管理员开启 [Mendeley 集成](https://ayakaleaf-pro.mintlify.site/zh-CN/on-premises/configuration/overleaf-toolkit/integrations/mendeley-integration.md)。

## 关联你的 Mendeley 账户

此操作只需做一次。

**1. 打开账户设置**

点击 **Account**，然后点击 **Account settings**。在 **Reference managers** 下找到 **Mendeley**，点击 **Link to Mendeley**。

![账户设置中的 Mendeley 部分，带有 Link to Mendeley 按钮](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/mendeley-link.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=43a88271d557e5660f474ae8e3e80cc0)

账户设置中的 Mendeley

编辑器 **Integrations** 面板中的 **Mendeley** 卡片会在同一标签页中带你到同一位置。

![带有 Mendeley 卡片的 Integrations 面板](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/mendeley-integrations.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=586224f164bf209f8b2d61c71730a5ef)

Integrations 面板

**2. 在 Mendeley 上授权**

Mendeley 页面会打开。如有提示请先登录，然后授权该应用。

**3. 检查关联**

你会回到账户设置。一条绿色消息显示 **Reference manager linked**，按钮变为 **Unlink**。

![账户设置中的 Mendeley 部分，带有绿色消息和 Unlink 按钮](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/mendeley-linked.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=bf37ef9eb9855e8de7b64877fba05670)

你的 Mendeley 账户已关联

如果你没有在 Mendeley 上允许访问，同一部分会显示 **Sorry, something went wrong**。点击 **Link to Mendeley** 重试。

## 从文献库创建文件

**1. 打开 Add files 对话框**

打开一个项目。在文件树中点击 **New file**，然后点击 **From Mendeley**。只有在账户关联后才会出现此项。

**2. 选择文件名和文献库**

**File Name** 默认为 `mendeley.bib`。请保留 `.bib` 扩展名：否则你将看不到预览，`\cite` 和 `\bibliography` 也都找不到其中的条目。

**Library** 默认为 **My Library**，同时还会列出你的群组。一个文件对应一个文献库。

![Add files 对话框的 From Mendeley 标签页，显示 mendeley.bib 和 My Library](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/mendeley-new-file.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=81c9f863e1a6da6682d085b9527a5656)

来自个人文献库的文件

**3. 点击 Create**

对话框关闭，文件出现在文件树中。点击它：会显示导入时间及其条目。你无法在编辑器中编辑它。

![在编辑器中打开的已导入 mendeley.bib，带有 Refresh 按钮](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/mendeley-file.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=3cb1a53b2e2e3d1e9c8fb052d6f746ae)

导入的文件

如果点击 **Create** 似乎没有反应，说明已存在同名文件。请换一个名称。

### 导入群组

再操作一次，使用单独的文件名，并在 **Library** 下选择该群组。一个项目可以有多个这样的文件。

![From Mendeley 标签页，文件名为 journal-club.bib，文献库为 Journal club](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/mendeley-group.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=36e33f80803a06290ecba88187949079)

来自群组的文件

## 从文件中引用

**1. 开始引用**

在 `.tex` 文件中输入 `\cite{`。列表会显示项目中所有 `.bib` 文件的条目。点击某一条即可插入。

![编辑器在引用下方列出引用键](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/mendeley-cite.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=644bc6dd85a43536dc1a9929c9d1f493)

已导入文件的条目

**2. 或按标题或作者搜索**

点击列表下方的 **Search**，或在花括号内按 Ctrl+Space。输入内容进行筛选，点击一个或多个条目，然后点击 **Insert**。

![Search the .bib files in this project 对话框，已选中一个条目](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/mendeley-search.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=66f386c49395254cfc7745a36b78a973)

文献搜索

**3. 添加参考文献列表**

在 `\end{document}` 之前添加以下几行，使用不带 `.bib` 的文件名。如有多个文件，用逗号分隔文件名。

```latex theme={null}
\bibliographystyle{plain}
\bibliography{mendeley}
```

点击 **Recompile**。参考文献会出现在 PDF 中。

![带有引用和参考文献列表的编辑器，以及包含一条参考文献的已编译 PDF](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/mendeley-compiled.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=a8cb25d3dd0768cb595735884b6bca5b)

编译后的参考文献

导入的文件不会出现在 **Settings** 的 **References**、**Main bibliography file for this project** 中，因此如果项目没有其他 `.bib` 文件，该列表会保持为空。你仍然可以从中引用。

![项目设置的 References 标签页，列表为空且已禁用](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/mendeley-settings-references.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=f2b0b675644de3d7060919be3f9f0bbe)

列表为空是正常的

## 刷新文件

Mendeley 文献库中的更改不会自动同步到项目。

**1. 打开文件**

在文件树中点击已导入的文件。

**2. 点击 Refresh**

整个文件会从你创建时选择的文献库重新导入：新条目出现，已删除的条目消失。顶部的时间会随之改变。

![刷新后的 mendeley.bib，带有一个新条目和新的导入时间](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/mendeley-refresh.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=3470237d13a4053875d1f7dafc1915d7)

刷新后的文件

**3. 重新编译**

点击 **Recompile** 更新 PDF。

每个文件单独刷新：请另行刷新群组的文件。关于在共享项目中谁可以刷新文件，请参阅[管理员说明](https://ayakaleaf-pro.mintlify.site/on-premises/configuration/overleaf-toolkit/integrations/mendeley-integration.md#notes)。

## 取消关联 Mendeley 账户

在 **Account settings** 的 **Mendeley** 下点击 **Unlink**，然后在对话框中再次点击 **Unlink**。按钮会重新显示 **Link to Mendeley**。

![Unlink Mendeley Account 对话框](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/mendeley-unlink.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=efaa5a483adc0fb81d35db0e4c2276ac)

取消关联账户

你导入的文件会保留在项目中，并且仍可编译。**From Mendeley** 会从 **Add files** 对话框中消失，在你重新关联账户之前，**Refresh** 会显示错误。

![已导入的文件显示错误 Could not load references from Mendeley, please re-link your account and try again](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/mendeley-relink-error.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=5aea2772a815befa17c3cf67d8a787d6)

未关联账户时刷新

重新关联后，**Refresh** 可以在相同的文件上正常使用。

## 如果出现问题

在 **Add files** 对话框中出现 **Could not load references from Mendeley, please re-link your account and try again** 或 **There was an error accessing your Mendeley data**：Overleaf 无法再读取你的文献库，例如你在 Mendeley 上撤销了它的访问权限。在 **Account settings** 中点击 **Unlink**，然后点击 **Link to Mendeley**。在此之前，**Create** 也会失败，并显示 **The project that contains this file is not shared with you**，即使是在你自己的项目中。

![From Mendeley 标签页，显示两条错误消息](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/mendeley-access-error.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=dd8bf5a40a1f9df1ee7e091a4b3b1249)

Overleaf 无法再读取你的文献库

点击 **Refresh** 时出现 **The remote service produced an error**：对 Mendeley 的请求失败。文件内容保持不变。请稍后再次点击 **Refresh**。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.