# zotero-cite **Repository Path**: rusterx/zotero-cite ## Basic Information - **Project Name**: zotero-cite - **Description**: 基于Zotero Better提供的json-rpc导出bib格式的文件列表。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 14 - **Forks**: 8 - **Created**: 2021-11-01 - **Last Updated**: 2026-04-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README 在markdown、pandoc（.md后缀）、quarto（.qmd后缀）、R Markdown（.rmd后缀）、MDX（.mdx后缀）以及latex文件的编写过程中，如果想要实现类似ms word文件的编辑过程，边插入边更新bib文件。或者想将当前文件的`key`列表，导出最终的bib文件，那么该插件就非常适合你。 ## 自动融合远程 Pull Requests 项目里新增了一个自动合并脚本，可按顺序抓取并合并远程 PR 引用到当前分支。 前提条件： - 当前目录是 git 仓库。 - 远程仓库暴露 PR 引用（默认使用 `refs/pull/*/head`，GitHub/Gitee 常见）。 - 建议在工作区干净（无未提交变更）时运行。 常用命令： ```bash # 仅预览将要合并的 PR，不执行 merge npm run sync:prs:dry # 实际执行自动合并 npm run sync:prs # 指定远程并限制最多合并 5 个 PR npm run sync:prs -- --remote upstream --limit 5 ``` 冲突处理： - 当某个 PR 合并冲突时，脚本会尝试执行 `git merge --abort` 保持工作区整洁。 - 默认遇到冲突即停止；如需继续处理后续 PR，可加 `--keep-going`。 ## issue与代码提交 由于本人不经常使用`latex`以及`markdown`，只在写论文的时候才会用，如果您喜欢使用该插件，但对其中的一些细节有额外的需求，您可以写issue，另外对于本身有一些编程能力的用户，非常欢迎提交自己的代码（请您务必认真自己测试提交的代码！因为我实在有点懒惰，不会仔细review代码）。 ## 插件功能 - Zotero Cite: Export BibLatex 查询当前编辑的markdown、pandoc或者latex文档，根据引用的key，导出引用至bib文件。 ![export bibliography.gif](https://s2.loli.net/2022/02/07/by74icsMBRuVfO9.gif) - Zotero Cite: Add Citation for Pandoc/Latex 如果你想在pandoc以及latex文档的书写过程中，希望插入citation，但是不想更新bib文件，那么这个功能比较适合你。 ![add citation for pandoc and latex.gif](https://s2.loli.net/2022/02/07/ZQSoTM69wdYAB4l.gif) - Zotero Cite: Cite and Create Bibliography for Pandoc/LaTeX 如果你想在pandoc以及latex文档的书写过程中，希望插入citation的同时更新bib文件，那么这个功能比较适合你。 ![add citation and add bibliography for pandoc and latex.gif](https://s2.loli.net/2022/02/07/vefSHTJWnG6DAt7.gif) - Zotero Cite: Cite and Create Bibliography for Markdown 如果你想在markdown / quarto（.qmd）/ R Markdown（.rmd）/ MDX（.mdx）文档的书写过程中，希望插入citation的同时更新脚注，那么这个功能比较适合你。 ![add citation and add bibliography for markdown.gif](https://s2.loli.net/2022/02/07/IcuWZpy7zLJFUsY.gif) - Zotero Cite: Cite Hyperlink ![VSCODE插入超链接引用.gif](https://s2.loli.net/2022/05/04/eMSAvoIQC9gViTG.gif) - Zotero Cite: Zotero Cite: Update BibTex Entries 从 Zotero 更新 defaultBibName 路径对应bib文件的所有项，存在未匹配项则不修改原始记录。 ## 插件配置项 - zotero-cite.defaultBibName：导出引用文件的默认路径。默认值为`ref.bib`。可以使用通配符：`${workspaceFolder}`、`${fileBasename}`、`${fileBasenameNoExtension}`、`${fileDirname}`、`${fileExtname}`。 - zotero-cite.latexBibStyle：导出的LaTeX引用格式，应为`bibtex`或`biblatex`。默认值为`bibtex`。 - zotero-cite.showMarkdownCitationHoverPreview：是否显示 Markdown 中 `[^key]` 与 `@key` 的 hover 预览。默认值为 `true`。 - zotero-cite.showMarkdownCitationCompletion：是否显示 Markdown 中 `[^` 与 `@` 的引用建议列表。默认值为 `true`。 ## 修改历史 - 2021-11-01：创建了zotero-export插件并增加了文件名输入的功能。增加when支持，只允许在markdown或者latex环境下激发命令。 - 2021-11-02：将zotero-export插件更名为export-cite，优化bibliography导出到文件的功能，使其支持latex环境。同时添加了`zotero-cite.citeBibliography`以及`zotero-cite.citeMarkdownBibliography`两个命令，使其可以在插入引用的同时，将bibliography插入到默认的文件中。 - 2022-02-06： 对zotero-cite进行了全面的修改，使其可以支持markdown、pandoc以及latex环境的引用插入。可以智能的识别当前鼠标的位置是否在引用环境中，从而决定是应该直接插入，还是采用新增的方式插入引用。 - 2022-02-07：优化pandoc以及latex文件的插入引用函数，消耗资源更少。 - 2022-05-04：添加了markdown环境下，超链接的引用功能。 - 2024-04-07：由于用户的贡献，插件支持最新的`Better BibTex for Zotero`插件。 - 2024-04-22: 由于用户的贡献，插件的`citekey`支持"-"和":"等特殊符号。 - 2024-04-22: 由于用户的贡献，插件的支持多个分组。 - 2024-06-13: 由于用户贡献，在使用`exportBibLatex`的时候，插件支持`\citet`和`\citep`命令。 - 2024-07-09: 由于用户的贡献，插件支持自定义ref文件的位置，并支持使用自定义通配符。 - 2026-02-02: 由于用户的贡献，在md和tex文件右上角添加了小按钮来插入引用。 - 2026-02-04: 由于用户贡献，修复了添加引用无法检测已经添加进来的重复条目的问题，修复了'update biblatex entries'功能，并增强了返回结果的体验。 ### 2026-04-20：重要更新 - 将js插件转换成ts，模块化，方便准确的代码提示。 - 增加了状态栏的command picker按钮，点击可以显示命令列表。 - 增加md文件中尖角引用和@引用的预览和建议列表功能，并做成可配置项（显示和隐藏）。 - 增加了json-rpc字段的排除配置（有时候一些不需要的字段不想显示在bib文件中）。 ## 教学视频 链接: https://pan.baidu.com/s/10FE43K7ZR4LhHv19_5qrnw?pwd=bjf6 提取码: bjf6 复制这段内容后打开百度网盘手机App，操作更方便哦 --来自百度网盘超级会员v9的分享