科研【免费下载链接】zotero-better-bibtexMake Zotero effective for us LaTeX holdouts项目地址https://gitcode.com/gh_mirrors/zo/zotero-better-bibtex点击查看免费下载Better BibTeXBBT是运行在 Zotero原则上也支持 Juris-M中的扩展插件核心目标是让以 LaTeX / Markdown 等纯文本工具链写作的用户能够高效、稳定地管理文献数据自动生成不冲突的引文键、把 Zotero 的 HTML 标记与 LaTeX 命令互相转换并提供高度可定制的 Bib(La)TeX / CSL 导出。读完本文你将掌握 BBT 的功能全貌、Zotero 8 引文键迁移的注意事项、引文键公式的基本语法以及如何利用自动导出、拉取导出与源码级机制来解决实际写作中的文献管理问题。Better BibTeX 是什么面向文本工具链用户的 Zotero 扩展BBT 是一个 Zotero 插件为两类用户解决痛点一类是使用 LaTeX / BibTeX / BibLaTeX 写作的用户另一类是使用 Markdown 配合 CSL 或 BibLaTeX 的现代写作流程用户。它与 Zotero 的关系是import/export 模块——只要 Zotero 能导出或导入文献条目你就能在选择列表中看到Better XBetter BibTeX、Better BibLaTeX、Better CSL JSON 等选项。即使你完全保留原有工作流仅使用 BBT 的 LaTeX ↔ Unicode 互转能力和更准确的字段映射也能立刻受益。相关导出的实现位于仓库 translators/Better BibTeX.ts、translators/Better BibLaTeX.ts 等翻译器入口中。重大变更Zotero 8 原生引文键字段取代 BBT 引文键字段原文档首先强调了一个对所有用户都重要的版本里程碑自 Zotero 8 起条目拥有了 Zotero 原生的引文键字段BBT 引文键字段已被取代。这带来如下几项略有破坏性的变化Zotero 7 不再受支持BBT 8.0.25 仍可在 Zotero 7.0.32 上运行但不会获得进一步更新。固定pinned键概念消失Zotero 会把所有原本固定在extra字段中的键迁移进原生字段。由于 Zotero 没有位置可以存储是否固定的标记键现在永远是固定的。存储位置迁移Zotero 原生引文键存储在另一处。如果你还没有原生引文键BBT 会静默迁移如果已有原生引文键且迁移会覆盖它们BBT 会弹出窗口让你选择如何把引文键从 BBT 存储迁移到 Zotero 存储。数据库直读集成受影响直接读取 BBT 数据库的第三方集成需要改为读取 Zotero 数据库。这一变更带来的最大好处是键可以同步了——引文键不再只存在于本地 BBT 存储而是随 Zotero 数据库本身在设备间同步。重新执行迁移Re-do migration如果键迁移看起来失败了请放心你的引文键是安全的。操作步骤为确认已升级到最新版本在 BBT 启动后的前 5 分钟内Help 菜单会出现Re-do BBT citation key migration选项点击它从 Help 菜单生成一份 debug 日志然后在 GitHub 上开 issue 并附上日志 ID。迁移逻辑的实现在仓库 content/key-manager/migrate.ts 中该模块负责新旧存储之间的键迁移与冲突处理。引文键生成设施稳定、无冲突、可自定义引文键是连接你的参考文献与正文引用的关键数据BBT 围绕它提供了一整套设施自动生成无冲突的引文键生成时会把库中已存在的键一并纳入考量即使这些键不属于本次导出的条目也能避免随机性破坏。也就是说无论你导出库的哪一部分、以什么顺序导出键的生成都是确定性的。基于引文键公式citekey formula生成根据条目内容按公式生成键公式语法详见 引文键文档 的 Configurable citekey generator 一节。稳定的自定义键与拖拽引用可以设置自己的稳定引文键把 LaTeX 引用直接拖进编辑器也可以添加自定义的 BibLaTeX 字段。公式引擎的实现位于 content/key-manager/formatter.ts格式化与过滤器执行和 content/key-manager/compile.js公式编译同时支持多种语言特性日文假名注音content/key-manager/japanese.ts、中文分词与拼音content/key-manager/chinese.ts、阿拉伯文content/key-manager/arabic.ts、西里尔文content/key-manager/cyrillic.ts等。引文键公式的四种构件与五种子公式BBT 的公式语言采用类 JavaScript语法取代了早期类 JabRef 语法。构成键的构件有四类函数functions基于条目产生文本如shorttitle。大体不区分大小写但必须以小写字母开头字段访问field access直接取 Zotero 条目字段的文本大体不区分大小写但必须以大写字母开头过滤器filters作用于函数、字段访问或子公式返回文本的动作完全忽略大小写可链式使用每个过滤器作用于上一个的输出裸字符串bare strings用单引号或双引号包裹的逐字文本。子公式subformula有五种构建方式且可以组合嵌套组合(auth title)交替(auth || title)——取第一个返回文本者auth有文本就用auth否则用title条件(auth title)——先确认第一个有文本才使用最后一个即仅当auth有返回值时才用title三元(auth ? year : title)——auth有文本则用year否则用title格式为condition ? output_if_true : output_if_false长度简写(auth title) 0或auth 0分别是(auth title).len/auth.len的简写例如(auth || shorttitle || year) ? (auth title) : (year || title)就是合法的组合。注意子公式不能出现在参数中如title.select(auth ? 3 : 4)不合法但过滤器可以作用于子公式例如(title || auth).lower。条件跳转与默认公式你还可以显式测试某部分是否为空并跳转到下一个公式用分号分隔多个公式title.lower.len year; auth year上面的写法表示title函数返回非空文本才使用第一部分否则跳到auth year。若要测试最小长度可用(title 1) year它是title.len(,1) year的简写。注意表达式必须加括号——公式遵循 JavaScript 运算符优先级title 1 year会被解析为title (1 year)。BBT 的默认键公式为auth.lower shorttitle(3,3) year含义是第一作者的姓去空格、因.lower过滤器转为小写标题的前n默认 3个词并对其中前m默认 0个词应用大写出版年份如有冲突时追加字母后缀a、b、c…此部分始终存在、不可关闭但可改成 Zotero 风格的数字后缀。如果你使用过 Zotero 标准 Bib(La)TeX 导出器生成的旧键为方便迁移可把公式设为zotero.clean。多公式、字面文本与实用示例可以在偏好设置中配置多个公式用分号;或竖线|分隔取第一个产生非空字符串的公式若全部为空则生成随机键。例如为长集体作者名的条目生成短键、否则回退默认extra(tex.shortauthor).transliterate.clean.lower.len year; auth.lower year字面文本可直接用引号加入公式extra(tex.shortauthor).transliterate.clean.lower.len year; default auth.lower year也可以把三元/或风格选择内嵌到公式中替代函数但不能放在参数里例如用(title ? title : auth).lower year或(title || auth).lower year替代title.len year; auth year。重要提醒修改公式不会更新任何现有引文键——新公式只对从修改那一刻起变更的条目生效。若要对已有条目应用新公式请选中条目右键选择 BBT - Refresh。完整的函数与过滤器列表见 functions and filters。其他引文键能力拖拽/快捷键引用可以把引用拖进 LaTeX/Markdown/Org-mode 编辑器自动生成\cite{citekey}、[citekey]、[[zotero://select...][citekey]]。cite命令可在偏好设置中配置不要包含前导反斜杠。一次性设置在 BBT 的Citation keys偏好中选择 Quick Copy 格式再到 Zotero 偏好设置的 Export 选项卡把 Default Output Format 设为 Better BibTeX Quick Copy: [所选格式]。在条目列表中显示引文键方便随时查看。引文键偏好细节见 偏好设置文档包括默认键公式auth.lower shorttitle(3,3) year、强制键纯文本默认yes等效于对所有键套用fold、条目变更时是否重生成键默认no、自动填充键的等待秒数默认2秒、键唯一性检查范围默认库内唯一可设为跨所有库全局唯一、以及日文假名注音与中文分词/拼音等可选功能后者会占用约 70MB 内存并拖慢启动非必需建议关闭。格式与编码转换HTML/LaTeX/Unicode 互转Zotero 全程使用 UTF-8 Unicode这本身是正确的选择但对于受制于传统 BibTeX、暂时无法迁移到 BibLaTeX 的用户Unicode 是一大痛点。同时Zotero 条目中的简单 HTML 标记是 Bib(La)TeX 无法理解的。BBT 解决这两个问题HTML 与 LaTeX 互转i.../i↔\emph{...}/\mkbibemph{...}/\textit{...}b.../b↔\textbf{...}sup.../sup↔\textsuperscript{...}sub.../sub↔\textsubscript{...}更多转换可按需扩展。转换实现位于 translators/bibtex/unicode_translator.ts它维护了全面的 LaTeX 构造清单例如\{o}或\o在导入时会被转换为 Unicode 等价形式ö若启用了相应选项导出时 Unicode 又会转回\{o}使用 BibLaTeX 时并非必须因为 BibLaTeX 对 Unicode 的支持相当好。字面 LaTeX 保留如果你需要在导出中保留字面 LaTeX用script.../script或pre.../pre标记包裹即可两者效果相同。导出设施高度定制的导出、自动导出与拉取导出BBT 为 Zotero 的导出对话框增加了多种导出格式并提供了若干提升纯文本写作体验的手段高度定制化导出在 Zotero 偏好设置的 Better BibTeX 选项卡中可微调导出行为例如从导出中省略字段以精简 bib 文件、配置引文键生成等修复日期字段导出forthcoming这类日期按原样导出而不是变成空值同时把合法日期规范化为无歧义的国际格式。日期解析实现在 content/dateparser.ts测试样例见 minitests/dateparser.ts自动导出auto export集合或整个库变更时自动重新导出详见 自动导出文档。实现位于 content/auto-export.ts拉取导出pull export通过内嵌的 web 服务器拉取导出详见 拉取导出文档。实现位于 content/pull-export.ts 与 content/server.ts自动期刊缩写自动把期刊名缩写实现见 content/journal-abbrev.ts。自定义导出字段与条目类型你可以在条目的extra字段中按行添加自定义导出字段两种格式均可tex.origdate 1856 tex.origtitle All This More或tex.origdate: 1856 tex.origtitle: All This More区别在于用分隔的字段被认为是有效原始LaTeX会原样写入生成文件用:分隔的字段被认为是纯文本LaTeX 特殊字符如上例中的会被转义。此外还有 CSL 字段格式{:original-date: 1856}或独立成行的Original Date: 1856它们不仅会导出到 Bib(La)TeX还会被 Zotero 参考文献管理器拾取。添加名为tex.entrytype的字段可覆盖导出的条目类型例如生成customa{citekeyhere, ....}。更详细的说明见 extra 字段文档。后台导出worker 线程导出为了应对大型文库BBT 会在隔离线程worker thread中执行导出避免 Zotero 在导出期间锁死。该特性自 5.2.0 引入被视为实验性功能如果遇到错误可在 BBT 高级偏好中把 parallel exports 滑块拖到0来临时禁用若 BBT 在后台导出中检测到错误会自动禁用后台导出并回退为前台导出可通过同一滑块拖回默认值1重新启用。相关实现见 content/worker/zotero.ts 与 content/worker/cache.ts。自动导出与 git / 云同步工作流在 Zotero 左侧面板右键点击库、分组或集合选择 Export Library… / Export Collection…用 BBT 的导出翻译器如 Better BibTeX导出并勾选Keep updated即完成自动导出注册——此后该库/集合的任何变更都会触发自动重新导出。自动导出有三种运行时机在偏好设置中配置on change尽快运行、on idleZotero 空闲数秒后运行、paused手动运行或改回前两者后运行此时导出仍会被调度只是等待许可。已注册的自动导出可在 BBT 偏好的Automatic exports选项卡中管理/移除但不能在此新建。把 BBT 生成的 bib(la)tex / 引文键同步到其他平台Overleaf、GitHub Actions 等有几种方案自动导出 云同步 URL 导入把 bib 文件导出到云共享文件夹勾选 keep updated生成直链在 Overleaf 通过 Add file - From external URL 导入。任何提供直链的云服务Dropbox、OneDrive 等都可行多人协作时各自重复导出到同一共享文件夹并使用相同文件名即可。git 支持在存放论文的 git 克隆中执行git config zotero.betterbibtex.push true再设置指向该目录的自动导出此后每次更新 BBT 都会依次执行git pull、导出、git add 你的库文件、git commit -m 你的库文件、git push。注意 git commit/push 不限于单个文件——你编辑的其他文件若被git add过也会一起提交推送最稳妥的做法是让 BBT 自动导出到一个独立的克隆仓库。拉取导出pull export细节通过http://127.0.0.1:23119/better-bibtex/collection?[collectionID].[format]Juris-M 端口为24119即可拉取书目。右键点击分组/库/集合并选择Download Better BibTeX export...可获取对应 URL。URL 参数支持exportNotes[true|false]useJournalAbbreviation[true|false]可以在构建流程中用它拉取库例如 Makefile 里用curl或在 LaTeX 中写\addbibresource[locationremote]{http://127.0.0.1:23119/better-bibtex/collection?/0/8CV58ZVD.biblatex}format的可选值包括bib/biblatexBibLaTeX、bibtexBibTeX、json/csljsonCSL-JSON、yaml/yml/cslyamlYAML 格式的 CSL-JSON、jzonBetterBibTeX JSON 调试格式以及任意现有 Zotero 翻译器 header 中的translatorID值。注意addbibresource远程拉取只在编译文档的系统与运行 ZoteroBBT 的系统相同时才有效且自 Zotero 5.0.71 起出于安全原因浏览器无法再访问该 URLcurl等程序化访问不受影响。后处理脚本postscript在 BBT 偏好的 Export 选项卡的 postscript 子页中可以编写 JavaScript 片段对每个即将写出的 Bib(La)TeX / CSL 条目执行后处理。postscript 适用于四个翻译器BetterBibLaTeX、BetterBibTeX、BetterCSLJSON、BetterCSLYAML。可用Translator.BetterBibLaTeX、Translator.BetterCSLCSL 两者任一等判断上下文。BetterTeX 后处理中条目对象为tex源 Zotero 条目为zoteroBetterCSL 中为csl。常用 API 包括tex.add增改字段支持name、value、bibtex、enclatex/verbatim/literal/raw/url、sep、html等参数、tex.remove、tex.addCreators把修改后的zotero.creators重新生成作者字段。调试时可用Zotero.debug(...)输出到 Zotero 调试日志。完整 API 与十余个示例脚本见 脚本编写文档后处理执行逻辑位于 translators/lib/postscript.ts。快速上手安装与使用安装方式很简单下载最新发布版若用 Firefox务必右键另存XPI 文件直接左键点击会被 Firefox 当作插件安装并报文件损坏然后在 Zotero 中主菜单 Tools Plugins选择 Plugins点击右上角齿轮选择 Install Plugin From File...选择刚下载的 .xpi点击 Install。初次安装后插件会自动更新到更新版本通常只需执行一次。注意两点其一BBT 的默认键与 Zotero 原生生成的键不同若想获得 Zotero 原生键可在偏好设置中把公式设为zotero——但除非你已有使用 Zotero 原生键导出的旧文献否则强烈不建议其二BBT 必须安装在 Zotero 中而非 Firefox 中。安装细节见 安装文档。工作原理从架构上看BBT 的行为与任何 Zotero 导入/导出模块一致凡是 Zotero 可以导出或导入文献条目的地方选择列表中都会出现Better X。其输出规范依据 BibTeX参考BibTeXing与Tame the BeaST手册和 BibLaTeX参考The BibLaTeX Package手册——由于这两种格式并没有被所有编辑器/处理器统一遵循的权威手册BBT 的实现采取务实态度以实际可用为准。导出器核心实现位于 translators/bibtex/bibtex.tsBibTeX、translators/bibtex/biblatex.tsBibLaTeX与 translators/bibtex/entry.ts条目组装。BBT 还具备一些周边能力LaTeX 辅助扫描content/aux-scanner.ts、Cite As You Writecontent/cayw.ts、JSON-RPC 接口content/json-rpc.ts文档见 site/content/exporting/json-rpc.md以及网页服务器content/server.ts。遇到问题怎么办问题反馈与支持使用上有任何疑问可以在 GitHub 上开 issue 求助。提交 bug 报告前请先浏览支持请求指南清晰完整的报告通常能获得极快的修复速度只接受最新版本的问题报告从 Help 菜单选择Send Better BibTeX debug report发送调试报告把红色 ID 贴进 issue也可选中特定集合/条目后右键选择同一命令发送针对性调试报告报告导入问题必须附带可复现的样例文件放在 gist 或可下载 URL不要粘贴进 issue一个 issue 只放一个问题不要劫持已有 issue。如果安装 BBT 后 Zotero 卡顿通常是缓存填充导致的一次性问题。赞分享科研【免费下载链接】zotero-better-bibtexMake Zotero effective for us LaTeX holdouts项目地址https://gitcode.com/gh_mirrors/zo/zotero-better-bibtex点击查看免费下载相关推荐Better BibTeX for Zotero 完全指南面向 LaTeX 工作流的引用管理与导出利器Better BibTeX for Zotero 完全指南面向 LaTeX 工作流的引用管理与导出利器 Better BibTeXBBT是 Zotero科研如何用Better BibTeX插件让Zotero完美支持LaTeX工作流如何用Better BibTeX插件让Zotero完美支持LaTeX工作流 作为LaTeX用户的你是否曾经为Zotero与LaTeX的兼容性而烦恼Bette科研Better BibTeX for Zotero提升LaTeX写作效率的终极指南Better BibTeX for Zotero提升LaTeX写作效率的终极指南 Better BibTeX for Zotero 是专为LaTeX用户设计的科研上一篇MyIP日志轮转配置管理不断增长的日志文件下一篇10分钟语音数据训出 AI 变声模型RVC 音色转换从 0 到 1 完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
