科研【免费下载链接】zotero-better-bibtexMake Zotero effective for us LaTeX holdouts项目地址https://gitcode.com/gh_mirrors/zo/zotero-better-bibtex点击查看免费下载导读Zotero 的标准字段有时无法容纳你希望出现在导出条目中的全部信息例如法律法规的court、专利申请的assignee、或任意自定义 LaTeX 字段。本文基于 Better BibTeX 官方文档 site/content/exporting/extra-fields.md系统讲解如何利用 Zotero 的 cheater syntax在extra字段中以独立行写入Label: value向导出结果注入任意字段并深入剖析 BBT 特有的tex./bibtex./biblatex.前缀语法、三种字段类型text/date/name的处理规则、原始 LaTeX 直通机制以及 postscript 中通过extra.kv.变量名访问这些字段的完整方式。读完后你将能精准控制 BibTeX/BibLaTeX 与 CSL JSON/YAML 的导出内容不再受 Zotero 内置字段限制。Cheater syntax在 Extra 字段中声明任意数据所有 Zotero 条目都自带一个extra字段它最初用于存放非结构化的补充信息。Zotero 的引文处理器支持在其中识别所谓的 cheater syntax——把每个字段写成独立的一行格式为Label: value例如Original Date: 1856 Court: Supreme Court of the United StatesBBT 同样理解这套语法并且额外添加了一种属于自己的cheater 语法下文 BBT 专属前缀 一节详述。此外BBT 还兼容一种更古老的写法官方文档明确标注该格式仍被支持但已废弃{:csl-variable: value}例如{:original-date: 1856}。两种写法效果等价但建议新数据一律使用Label: value形式。解析器的正则实现BBT 对这两种格式的解析可以在 content/extra.ts 中看到。解析器维护三套正则const re { old: /^{:(?key[^:])(?assign:)\s*(?value[^}])}$/i, // 废弃的 {:csl-var: value} 形式 new: /^(?:(?tex(bib(la)?)?tex\.)|(?cslcsl\.))?(?key[^:])\s*(?assign[:])\s*(?value[\S\s]*)/i, // Label: value quoted: /^(?:(?tex(bib(la)?)?tex\.)|(?cslcsl\.))?(?key[^])\s*(?assign[:])\s*(?value[\S\s]*)/i, // 带引号的 Label }注意new正则已经内建了对可选前缀tex.、biblatex.、bibtex.、csl.的识别并用:或两种赋值符区分不同的处理模式quoted变体则允许把带空格的标签用引号包裹Label: value且解析顺序上先匹配 quoted 再匹配 new避免引号内的冒号干扰。三种字段类型BBT 把 cheater 字段分为三类类型说明示例text普通文本原样处理Archive: BNF archivesdate日期值Original Date: 1856-03-04name人名/机构名Interviewer: Emily WatsonDate日期BBT 会尽最大努力解析各种疯狂的日期写法这也是 content/dateparser.ts 存在的意义但如果希望结果稳定一致官方文档强烈建议统一使用YYYY-MM-DD格式。Name人名可以只写一段文本——等价于 Zotero 中的单段式名称机构名也可以使用||分隔符显式给出姓与名Interviewer: Watson || Emily在 content/extra.ts 中可以看到name 类型值会按/\s*\|\|\s*/切分为两部分cslCreator将其映射为 CSL 的{ family, given }结构单段则作为literal即机构名zoteroCreator则映射为 Zotero 的{ lastName, firstName }结构。因此在 CSL 与 Zotero 两条导出链路中name 字段都会被正确处理。字段如何映射到导出变量重要但略有绕写入extra的标签会被映射到两种不同的变量体系Zotero 字段如accessDate、archiveLocation、DOI、pagesCSL 变量如accessed、original-date、DOI、page。映射到哪个体系取决于你导出到哪种格式官方文档自己也承认这一点 depends (sorry)导出到 CSLBetter CSL JSON / Better CSL YAML时优先尝试映射到对应的 CSL 字段如果找不到对应的 CSL 字段则以Zotero 字段名暴露。导出到 Better BibTeX / Better BibLaTeX 时优先尝试映射到对应的 Zotero 字段如果找不到对应的 Zotero 字段则以CSL 变量名暴露。这一逻辑在 content/extra.ts 中有精确实现if (options.kv) { const [ primary, secondary ] mode csl ? [csl, zotero] : [zotero, csl] if (key _eprint) { extraFields.kv![key] value; return false } if ((ef Schema.labeled[primary][key]) addMappedField(ef, value)) return false // Secondary fallback only when the key is not known in the primary mode. // Unprefixed type does not fall back to CSL in Zotero mode. if ((mode csl || key ! type) !Schema.labeled[primary][key] (ef Schema.labeled[secondary][key]) addMappedField(ef, value)) return false }其中mode在 bibtex 导出器调用Extra.get(item.extra, zotero)见 translators/bibtex/exporter.ts时为zotero在 CSL 链路则传csl。Schema.labeled是 BBT 在 content/item-schema.ts 中构建的标签 → 字段双向索引zotero与csl两张查找表它由 Zotero 与 CSL 的 JSON schema 驱动生成。在 postscript 中访问这些字段这些 extra 字段在 postscript脚本化导出 中统一以extra.kv.变量名暴露。具体是哪个变量名遵循上面的映射规则CSL 导出用 CSL 名失败则 Zotero 名Bib(La)TeX 导出用 Zotero 名失败则 CSL 名。extra.kv只是解析结果Fields结构的一部分完整结构见 content/extra.tsexport type Fields { raw: Recordstring, string // 未归一化的原始键值 kv?: Recordstring, string // 按模式映射后的 text/date 字段 csl?: Recordstring, string // 显式 csl.* 前缀字段 creator: Recordstring, string[] // name 类型字段按 creator 角色分组 creators: Creator[] // name 类型字段的完整列表 tex?: Recordstring, TeXString // tex./bibtex./biblatex. 前缀字段 aliases?: string[] // 引文键别名 }在导出端BibTeX/BibLaTeX 导出器确实大量消费这个结构例如 translators/bibtex/bibtex.ts 中item.DOI || item.extraFields.kv!.DOI与item.url || item.extraFields.kv!.url以及 translators/bibtex/biblatex.ts 中的 URL/DOI 回退逻辑——这意味着即使条目没有填写标准url/DOI字段你也可以通过 cheater 语法补上。CSL 侧同样如此见 translators/csl/csl.tsextraFields.kv!.originalDate参与日期回退。BBT 专属前缀tex. / bibtex. / biblatex.除了标准的 cheater 语法BBT 还提供一套专属的 extra 字段格式tex.field: value这些字段不会被映射到任何 Zotero/CSL 变量而是被 BBT原样复制到输出中。例如在extra中写tex.bestfield: philosophy导出的 Bib(La)TeX 中就会出现bestfield {philosophy}即tex.前缀之后的bestfield直接成为 bib(la)tex 字段名。限定导出目标bibtex. 与 biblatex.你可以通过更换前缀让字段只在某一类导出中出现tex.bestfield:—— 无论 BibTeX 还是 BibLaTeX 导出都会输出bibtex.bestfield:—— 仅在BibTeX导出时输出biblatex.bestfield:—— 仅在BibLaTeX导出时输出。这个前缀过滤逻辑在 translators/bibtex/exporter.ts 中实现导出器先按当前翻译器this.translation.BetterBibLaTeX ? biblatex. : bibtex.选出目标前缀再与通用前缀tex.一起把匹配的字段剥掉前缀后进入输出不匹配的字段被删除if (item.extraFields.tex) { // strip extra.tex fields that are not for me const prefix this.translation.BetterBibLaTeX ? biblatex. : bibtex. for (const [ name, field ] of Object.entries(item.extraFields.tex).sort((a, b) strcmp.variant(b[0], a[0]))) { for (const type of [ prefix, tex. ]) { if (name.startsWith(type)) { item.extraFields.tex[name.substr(type.length)] field break } } delete item.extraFields.tex[name] } }排序时tex.在biblatex./bibtex.之前因此同一标签同时出现tex.与bibtex.变体时后者优先。:与文本转义 vs 原始 LaTeX 直通前缀字段的分隔符同样有两种语义截然不同:冒号冒号之后的内容被视为普通文本。BBT 会对其进行 LaTeX 转义例如会被转义并应用大小写保护规则。等号等号之后的内容被视为raw LaTeX——BBT不做任何转义原样照抄进输出文件。因此官方文档给出了一对正反示例。想要文本转义与大小写保护时用冒号tex.corp: Black Decker tex.formula $\sum\limits_{i1}^{n} -p(m_{i})\log_{2}(p(m_{i}))$而下面这种写法是有问题的——公式用了冒号会被转义破坏用了等号则变成未转义的裸 LaTeXtex.corp Black Decker tex.formula: $\sum\limits_{i1}^{n} -p(m_{i})\log_{2}(p(m_{i}))$注意同一行里与$...$混用时必须各自选对分隔符这正是上面第一个示例的用意。该模式assign 时mode raw同样定义在 content/extra.tsconst texmode (assign ) ? raw : (tex (tex.includes(T) || tex.match(/^[A-Z]/)) ? cased : undefined)TeXString类型content/extra.ts就是{ value, mode?: raw | cased, line }三要素raw对应cased对应大小写保护见下一节line记录其在 extra 中的原始行号以便报错定位。大小写保护在前缀中加入大写BBT 会对非 raw即冒号形式的字段应用大小写保护规则——你只需把前缀里的字母大写即可。例如TeX.corp: Black Decker就会以大小写保护的方式输出corp字段从而在标题化title-casing时保护词首大写。实现上texmode判定中的tex.includes(T) || tex.match(/^[A-Z]/)正是检测前缀是否含大写字母content/extra.ts随后字段键会被tex tex tex.toLowerCase()归一化而mode: cased保留在TeXString中供编码器使用。两个需要注意的限制这些 BBT 专属字段只被 BBT 认识。官方文档明确提醒其他导出器不认识tex./bibtex./biblatex.前缀某些第三方导出器甚至可能把它们当作 notes 输出——这是无法干预的。它们同样会被 Zotero 的引文处理器忽略不像无前缀的 CSL 变量那样参与 Zotero 内部引文处理。完整标签 / 变量对照表官方文档在 site/layouts/shortcodes/extra-fields.md 中维护了一份完整的标签对照表通过 Hugo shortcode{{% extra-fields %}}注入文档。表格列出的是Zotero 字段而不是 bibtex 字段——Zotero 字段到 bibtex 字段的翻译非常复杂官方暂未提供简明的对应描述。下表精选了最常用的标签完整列表约 150 项请直接查看上述 shortcode 文件标签Label类型Zotero 字段CSL 变量Original DatedateoriginalDateoriginal-dateAuthornameauthor / creatorauthorContainer Titletextcode / publicationTitle / reportercontainer-titleDatedatedateissuedDOItextDOIDOIEvent PlacetexteventPlaceevent-placeFiling DatedatefilingDatesubmittedGenretextgenre / programmingLanguage / typegenreIssuetextissue / priorityNumbersissueIssueddatedateissuedNumbertextnumbernumberPagestextpagespagePublication TitletextpublicationTitlecontainer-titlePublishertextpublisherpublisherReferencestexthistory / referencesreferencesRightstextrightslicenseSeriestextseriescollection-titleSourcetextlibraryCatalogsourceTitletexttitletitleURLtexturlURLVolumetextcodeNumber / volumevolumeYear Suffixtext—year-suffix表注① 标记为 Juris-M only 的字段如attorneyAgent、assignee、court、wordsBy等法律领域字段仅在 Juris-M 中受支持标准 Zotero 中部分标签如applicationNumber、archiveID / number、issueDate等会通过斜杠/给出的多个 Zotero 字段做回退映射。几个值得特别说明的映射细节同一 Zotero 字段可能由多个标签共享如publicationTitle同时由Blog Title、Book Title、Container Title、Dictionary Title、Proceedings Title、Publication Title、Session Title、Website Title等标签映射同一标签也可能映射到多个 Zotero 字段斜杠分隔取第一个命中的custom标签没有对应的 Zotero/CSL 字段表格中留空用于携带纯自定义信息多个 CSL 变量如title-short、archive_location、first-reference-note-number在 Zotero 侧没有对应字段它们正是导出到 Bib(La)TeX 时以 CSL 变量名暴露的典型场景反之archiveID、codePages、reporterVolume、seriesText等只有 Zotero 字段没有 CSL 变量属于导出到 CSL 时以 Zotero 字段名暴露的情况。实战建议与注意事项日期用 ISO 格式BBT 虽然会尽力解析各种人类花式日期March 4, 1856、1856/03等但为了跨导出器与跨版本的一致结果请一律使用YYYY-MM-DD。人名用 || 分隔需要结构化人名时使用family || given姓在前、名在后符合 CSL/Zotero 的惯用顺序单个字符串则按机构/单段名处理。raw LaTeX 的边界只有当你确定内容已是合法 LaTeX 时才用包含、%、_、$等特殊字符的普通文本务必用:让 BBT 完成转义。postscript 联动所有 cheater 字段都可以在 postscript 中通过extra.kv.变量名读取配合tex.add({ name, value, enc })API 可以做非常精细的二次加工而tex.前缀字段则可以直接驱动tex.entrytype这类特殊字段——在 translators/bibtex/entry.ts 中可以看到tex.entrytype的值会被用作导出条目的类型例如强制输出customa{...}之类条目tex.referencetype作为其过渡期别名同样被支持。免去为每个条目手工输入的自动化把反复使用的 cheater 行写入 string 偏好preferences 或利用自动导出 模板可以避免在每条记录里重复手工输入相同字段这也是官方推荐的工作流方向详见 自动导出。总结Zotero 的extra字段 cheater syntax 提供了一条不修改任何源码即可注入任意导出字段的通道而 BBT 在此基础上追加了tex./bibtex./biblatex.前缀、raw LaTeX 直通和大小写保护让 Bib(La)TeX 用户得以完全掌控最终 .bib 文件的内容。核心实现集中在 content/extra.ts解析与映射、content/item-schema.ts标签索引与 translators/bibtex/exporter.ts前缀过滤三处配合文末的完整标签对照表你可以随时查表定位任意标签在 Zotero 与 CSL 两侧的落点。赞分享科研【免费下载链接】zotero-better-bibtexMake Zotero effective for us LaTeX holdouts项目地址https://gitcode.com/gh_mirrors/zo/zotero-better-bibtex点击查看免费下载相关推荐Zotero Better BibTeX 终极指南CSL JSON与CSL YAML导出格式详解Zotero Better BibTeX 终极指南CSL JSON与CSL YAML导出格式详解 想要让Zotero引用管理更加高效专业吗 作为LaTe科研pandoc 将 BibTeX 转换为 CSL JSONurl 与 doi 字段的逐字输出行为详解pandoc 将 BibTeX 转换为 CSL JSONurl 与 doi 字段的逐字输出行为详解 导读 本文围绕 pandoc 的命令行用法 pandoc文档开发工具CLI上一篇openpilot部署实战5个高效技巧解决驾驶辅助系统核心问题下一篇洛雪音乐音源终极指南5分钟打造你的免费高品质音乐库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考