Zotero Better BibTeX 中处理文献关系的 Eta 模板实践

在学术研究过程中，文献管理工具Zotero及其插件Better BibTeX为研究人员提供了强大的文献组织和引用功能。本文将深入探讨如何利用Eta模板在Zotero中处理文献关系数据，实现高效的文献信息导出。

文献关系处理的技术挑战

Zotero中的文献关系数据（relations）存储了文献之间的关联信息，如相同文献（owl:sameAs）等。这些关系数据在导出时呈现为复杂的嵌套结构，给模板处理带来了挑战。关系数据可能以两种形式存在：

1. 简单列表形式：包含直接的关系URI数组
2. 结构化形式：以键值对形式组织，键表示关系类型，值为URI数组

Eta模板解决方案

Eta是一种轻量级JavaScript模板引擎，在Better BibTeX中被用于定制文献导出格式。针对关系数据的处理，我们开发了以下解决方案：

<%- 
const relations = []
if (item.relations) {
  for (const [kind, rels] of Object.entries(item.relations)) {
    for (const rel of rels) {
      relations.push(rel)
    }
  }
}
-%>

这段代码首先初始化一个空数组relations，然后检查item对象中是否存在relations属性。如果存在，则遍历relations对象的所有键值对，将所有的关系URI提取并存入relations数组。

完整模板实现

基于上述关系处理逻辑，我们构建了完整的Markdown导出模板：

<%- for (const item of it.items) {
  // 提取文献选择链接
  const [ , kind, lib, key ] = item.uri.match(/^https?:\/\/zotero\.org\/(users|groups)\/((?:local\/)?[^/]+)\/items\/(.+)/)
  const select = (kind === 'users') ? `zotero://select/library/items/${key}` : `zotero://select/groups/${lib}/items/${key}`

  // 处理关系数据
  const relations = []
  if (item.relations) {
    for (const [kind, rels] of Object.entries(item.relations)) {
      for (const rel of rels) {
        relations.push(rel)
      }
    }
  }
-%>
- ### <%= item.title %>
  <%- if (item.creators.length) { -%>
  
creators:: <% item.creators.forEach((creator, i) => { %><%= creator.creatorType %>: <%= creator.name || `${creator.firstName || ''} ${creator.lastName || ''}`.trim() %><% if (i < item.creators.length - 1) { %>, <% } %><% }) %>
  <%- } -%>
  <%- if (item.url) { -%>
  
url:: <%= item.url %>
  <%- } -%>
  <%- if (item.tags.length) { -%>
  
tags:: <% item.tags.forEach((tag, i) => { %>#[[<%= tag.tag %>]]<% if (i < item.tags.length - 1){%>, <%}%><% }) %>
  <%- } -%>
  
zotero::[@<%= item.citationKey %>](<%= select %>)
  - #### abstractNote
    <%= item.abstractNote %><%= "\r" %>
    <%- if (item.notes.length) { -%>
  - #### Notes
      <%- for (const note of item.notes) { -%>
    - ##### Note [<%= note.key %>](<%= note.uri %> "URI Link")
      <%~ note.note %>
      <%- } -%>
    <%- } -%>
  <%- if (relations.length) { -%>
  
  - #### Relations
    <%- for (const rel of relations) { -%>
  - <%= rel %>
    <%- } -%>
  <%- } -%>
  <%- if (item.rights) { -%>
  
  - #### Rights
    - <%= item.rights %>
  <%- } -%>
<%- } -%>

技术要点解析

1. URI解析：通过正则表达式提取文献的URI组件，构建可直接在Zotero中打开文献的选择链接。

2. 创作者处理：智能处理创作者姓名，无论是组织名称（name字段）还是个人姓名（firstName+lastName组合）。

3. 标签格式化：将标签转换为适合Logseq等知识管理系统的双括号链接格式。

4. 笔记内容处理：使用<%~语法自动转义HTML内容，确保笔记中的HTML标签能正确显示。

5. 关系数据展平：将可能存在的多层嵌套关系数据结构展平为简单URI列表，便于后续处理。

实际应用效果

该模板最终生成的Markdown格式能够完美适配Logseq等知识管理系统，实现了：

• 清晰的文献元数据展示
• 完整的创作者信息
• 可点击的文献链接
• 结构化的标签系统
• 格式化显示的笔记内容
• 完整呈现的文献关系网络

注意事项

1. 当文献被复制到其他群组时，关系数据不会自动保留，需要手动重建。

2. 关系URI必须指向实际存在的文献条目，否则可能无法正确解析。

3. 在Zotero 7中，关系数据的处理可能会有新的特性和改进。

通过这套Eta模板解决方案，研究人员可以轻松地将Zotero中的文献信息及其复杂关系网络导出为结构化的Markdown格式，极大提升了学术知识管理的效率。