[Item] 自用模板、合并吸取了两个社区的

[xfap]

Description

吸收

• Templates for co-working with obsidian, tested on zotero 7 release #1099
• [Item] template include relations and attachments 自用与Obisidian联动并包含关联文件和附件 #1372

相较于1099，参考 1272 增加了相关文档条目；

Screenshots

Test on Zotero version

8.0.3

Test on Better Notes version

3.0.2

Template Type

Item

Template Share Code

# This template is specifically for importing/sharing, using better 
# notes 'import from clipboard': copy the content and
# goto Zotero menu bar, click Tools->New Template from Clipboard.  
# Do not copy-paste this to better notes template editor directly.
name: "[item]Paper Notes"
zoteroVersion: "8.0.3"
pluginVersion: "3.0.2"
savedAt: "2026-03-07T07:29:22.494Z"
content: |-
  ${ await(async() => {
      // 将函数改为 async 以确保异步操作完成
      const getRelation = async (_item) => {
          try {
              // 获取相关条目的URI
              let relations = _item.getRelations();
              let relatedItemURIs = [];
              
              // 遍历所有关系类型，查找相关条目关系
              for (let relationType in relations) {
                  if (relationType.includes('dc:relation')) {
                      let uris = relations[relationType];
                      if (Array.isArray(uris)) {
                          relatedItemURIs = relatedItemURIs.concat(uris);
                      } else if (uris) {
                          relatedItemURIs.push(uris);
                      }
                  }
              }
              
              // 如果没有相关条目，返回提示信息
              if (!relatedItemURIs || relatedItemURIs.length === 0) {
                  return '<span style="color: gray;">无相关条目</span>';
              }
              
              // 构建HTML输出
              let html = '';
              
              // 遍历每个相关条目URI
              for (let i = 0; i < relatedItemURIs.length; i++) {
                  let uri = relatedItemURIs[i];
                  if (!uri) continue;
                  
                  // 从URI中提取条目key
                  let key = uri.split('/').pop();
                  if (!key) continue;
                  
                  try {
                      // 获取条目（使用正确的libraryID）
                      let libraryID = _item.libraryID || Zotero.Libraries.userLibraryID;
                      let item = Zotero.Items.getByLibraryAndKey(libraryID, key);
                      
                      if (item) {
                          // 获取条目标题
                          let title = item.getField("title") || 
                                     item.getField("citationKey") || 
                                     (typeof item.getDisplayTitle === 'function' ? item.getDisplayTitle() : null) || 
                                     key;
                          
                          // 获取附件信息
                          let attachments = item.getAttachments();
                          if (attachments && attachments.length > 0) {
                              let attachmentItem = Zotero.Items.get(attachments[0]);
                              if (attachmentItem && attachmentItem.isPDFAttachment()) {
                                  let attachKey = attachmentItem.key;
                                  let filename = attachmentItem.getFilename();
                                  html += `<div>📄 <a href="zotero://open-pdf/0_${attachKey}">${title}</a></div>`;
                              } else {
                                  // 有附件但不是PDF，或无法获取
                                  html += `<div>📎 <a href="zotero://select/items/${item.key}">${title}</a></div>`;
                              }
                          } else {
                              // 没有附件，只显示条目链接
                              html += `<div>📑 <a href="zotero://select/items/${item.key}">${title}</a></div>`;
                          }
                      } else {
                          // 如果获取条目失败，使用key作为链接文本
                          html += `<div>❓ <a href="zotero://select/items/${key}">${key} (未找到条目)</a></div>`;
                      }
                  } catch (e) {
                      // 单个条目处理失败，继续处理其他条目
                      html += `<div>⚠️ 加载失败: ${key}</div>`;
                  }
              }
              
              // 如果最终html为空，说明所有条目都处理失败
              if (!html) {
                  return '<span style="color: gray;">无相关条目</span>';
              }
              
              return html;
          } catch (e) {
              // 如果发生任何错误，返回错误信息和备用链接
              return `<span style="color: red;">错误: ${e.message}</span> <a href="zotero://select/items/${_item.key}?tab=related">点击查看相关条目</a>`;
          }
      }
  
      let res = `
          <h1 style="color:#193c47; background-color:#eef9fd; padding:8px;">
          ${(() => {
              const date = topItem.getField("date").split('T')[0];
              const title = topItem.getField("title");
              const titleTranslation = topItem.getField("titleTranslation");
              if (date && titleTranslation) {
              return `${title}`;
              } else if (date) {
              return `${title}`;
              } else {
              return `${title}`;
              }
          })()}
          </h1>
      
      <h2>⚙️ Metadata</h2>
      
      <ul>
          <li><b>Item Type:</b>
          ${topItem.itemType}
          </li>
      
          <li><b>Author:</b> 
          ${(() => {
              let author = topItem.getCreators().slice(0, 10).map((v) => v.firstName + " " + v.lastName).join("; ") + (topItem.getCreators().length > 10 ? "; et al." : ";");
              let names = String(author);
              if (names.endsWith(';')) {
                  names = names.slice(0, -1);
              }
              names = names.split(/;\s*/);
              let wrappedNames = names.map(name => `[[${name.trim()}]]`);
              return wrappedNames.join(', ');
          })()}
          </li>
      
      
          <li><b>Date Added:</b>
          ${new Date().toLocaleString()}
          </li>
      
          <li> 
          ${(() => {
                  const doi = topItem.getField("DOI");
                  if (doi) {
                  return `<b>DOI: </b> <a href="https://doi.org/${topItem.getField('DOI')}">${topItem.getField('DOI')}</a>`;
                  } else {
                  return `<b>URL: </b><a href="${topItem.getField('url')}">${topItem.getField('url')}</a>`;
                  }
              })()}
          </li>
      
          <li><b>Cite key: </b>
          ${(topItem.getField("extra").match(/Citation Key:\s*(.*?)($|\n)/) ? topItem.getField("extra").match(/Citation Key:\s*(.*?)($|\n)/)[0] : "").replace(/(\r\n)|(\n)/g, "").split(":").slice(1)}
          </li>
      
          <li><b>Journal: </b>
          ${topItem.getField('publicationTitle')}
          </li>
      
          <li><b>Journal Tags: </b> 
          ${(() => {
              let separator = " | "; 
              let textContent = Array.prototype.map.call(
                  Zotero.ZoteroStyle.api.renderCell(topItem, "publicationTags").childNodes,
                  e => separator + e.outerHTML
              ).join('');
              textContent = textContent.slice(separator.length);
              return textContent;
          })()}
          </li>
      
      <li><b>Publication Date: </b> 
          ${topItem.getField("date").split('T')[0]}
          </li>
      
          <li><b>Tags:</b> 
          ${(() => {
              let str = topItem.getTags().map(tagObj => tagObj.tag);
              let templatestr = ", zotero";
              let words = (String(str) + templatestr).split(/,\s*/);
              let hashtaggedWords = words.map(word => `#${word.trim()}`);
              return hashtaggedWords.join(', ');
          })()}
          </li>
      
          <li> <b>PDF Attachments: </b>
          ${(() => {
                  const attachments = Zotero.Items.get(topItem.getAttachments());
                  const pdf = attachments.filter((i) => i.isPDFAttachment());
                  if (pdf && pdf.length > 0) {
                  return `<a href="zotero://open-pdf/library/items/${pdf[0].key}">${pdf[0].getFilename()}</a>`;
                  } else if (attachments && attachments.length > 0) {
                  return `<a href="zotero://open-pdf/library/items/${attachments[0].key}">${attachments[0].getFilename()}</a>`;
                  } else {
                  return ``;
                  }
              })()}
          </li>
          <li> <b>Related Items: </b>
          ${await getRelation(topItem)}
          </li>
      </ul>
      
          <h2 >📜 Abstract</h2>
      
              ${(() => {
                  const abstractTranslation = topItem.getField('abstractTranslation');
                  if (abstractTranslation) {
                  return `${abstractTranslation}</i>`;
                  } else {
                  return `${topItem.getField('abstractNote')}`;
                  }
              })()}
          
      
      <h2>📚 Zotero links</h2>
      
      <ul>
      <li>
          <a href="zotero://select/items/1_${topItem.key}">Local library</a>
          </li>  
      </ul>
  
      <h1>Notes</h1>
  
      <h2>🤔 Personal Summary</h2>
      
          <h3>💭 Thought Inspiration</h3>
          <blockquote>Tips: What aspects did you question, how do you think it can be improved?</blockquote>
          <p></p>
      
          <h3>📜 Conclusion</h3>
          <blockquote>Tips: What was done, what problem was solved, innovations and shortcomings?</blockquote>
          <p></p>
      `;
      return res;
  })()}

Anything else

Others needed

Export MD File Content

# This template is specifically for importing/sharing, using better 
# notes 'import from clipboard': copy the content and
# goto Zotero menu bar, click Tools->New Template from Clipboard.  
# Do not copy-paste this to better notes template editor directly.
name: "[ExportMDFileContent]"
zoteroVersion: "8.0.3"
pluginVersion: "3.0.2"
savedAt: "2026-03-07T07:32:56.027Z"
content: |-
  ${mdContent.replaceAll("\\[\\[", "[[")}

Export MD File Header

# This template is specifically for importing/sharing, using better 
# notes 'import from clipboard': copy the content and
# goto Zotero menu bar, click Tools->New Template from Clipboard.  
# Do not copy-paste this to better notes template editor directly.
name: "[ExportMDFileHeaderV2]"
zoteroVersion: "8.0.3"
pluginVersion: "3.0.2"
savedAt: "2026-03-07T07:34:17.034Z"
content: |-
  ${{
    // 初始化一个空对象来存储所有元数据
    let header = {};
    
    // 获取笔记所附着的 Zotero 文献条目
    const parent = noteItem.parentItem;
  
    // --- 核心元数据提取 ---
    if (parent) {
      // 获取Citekey
      header.citekey = parent.getField("citationKey") || "";
  
      // 获取原始标题
      const originalTitle = parent.getField("title") || "";
      header.parent = originalTitle;
      
      // 翻译标题
      header.title_ZH = parent.getField('titleTranslation') || "";
  
      // 设置别名 (aliases)
      header.aliases = "0"; // 可以随意赋值，例如 0 或 null
  
      // 按指定格式处理作者
      const creators = parent.getCreators();
      if (creators.length > 0) {
          const authorNames = creators.slice(0, 10).map(c => `${c.firstName || ''} ${c.lastName || ''}`.trim());
          header.authors = authorNames.join(";") + (creators.length > 10 ? "; et al." : ";");
      } else {
          header.authors = "";
      }
  
      // 获取期刊或会议名
      header.journal = parent.getField("publicationTitle") || "";
  
  	// 获取期刊标签 (Journal Tags)
      try {
          header.journal_IF = Array.prototype.map.call(
              Zotero.ZoteroStyle.api.renderCell(parent, "publicationTags").childNodes,
              e => e.innerText.trim()
          );
      } catch (e) {
          header.journal_IF = [];
      }
  
      // 获取年份
      const date = parent.getField("date");
      header.year = date ? date.substring(0, 4) : "";
  
      // 获取 DOI 
      const doiValue = parent.getField("DOI");
      header.doi = doiValue ? `https://doi.org/${doiValue}` : "";
      
      // 获取 URL
      header.url = parent.getField("url") || "";
  
  
  
      
      
      // 获取Zotero链接
      const attachments = Zotero.Items.get(parent.getAttachments());
      const pdf = attachments.find((i) => i.isPDFAttachment() && !i.isTrashed);
      header.zotero_link = pdf ? `zotero://open-pdf/0_${pdf.key}` : `zotero://select/library/items/${parent.key}`;
  
  	// 获取文献所属的Zotero文件夹
  	header.zotero_folder = (
  		await Zotero.Collections.getCollectionsContainingItems([
  		(parent || noteItem).id,
  		])
  	).map((c) => c.name);
  
      // 获取摘要
      header.abstract = parent.getField('abstractTranslation') || parent.getField('abstractNote') || "";  //获取包括中文摘要
      //header.abstract = parent.getField('abstractNote') || "";
  
    } else {
      // 独立笔记的默认空值
      header.citekey = ""; 
  	header.authors = ""; 
  	header.year = ""; 
  	header.journal = ""; 
  	header.doi = ""; 
  	header.url = ""; 
  	header.parent = ""; 
  	header.title_ZH = ""; 
  	header.aliases = []; 
  	header.journal_IF = []; 
  	header.zotero_link = ""; 
  	header.abstract = "";
  	header.zotero_folder = "";
    }
  
    // --- 标签处理与自定义元数据 ---
    // 合并所有标签
    const itemTags = parent ? parent.getTags().map(t => t.tag).filter(t => t.startsWith('#')) : [];
    const noteTags = noteItem.getTags().map(t => t.tag);
    const allTags = new Set([...itemTags, ...noteTags]);
    allTags.add("literature-note");
    header.tags = [...allTags];
    
    // 自定义的字段
    header.summary = "**待补充**";
      
    // 重要性
    header.rating = parent ? parent.getTags().map(t => t.tag).find(t => t.startsWith('⭐')) : [];
    // 返回格式化后的JSON字符串
    return JSON.stringify(header);
  }}$

Export File Name

# This template is specifically for importing/sharing, using better 
# notes 'import from clipboard': copy the content and
# goto Zotero menu bar, click Tools->New Template from Clipboard.  
# Do not copy-paste this to better notes template editor directly.
name: "[ExportMDFileNameV2]"
zoteroVersion: "8.0.3"
pluginVersion: "3.0.2"
savedAt: "2026-03-07T07:35:08.970Z"
content: |-
  ${(noteItem.getNoteTitle ? noteItem.getNoteTitle().replace(/[/\\?%*:|"<> ]/g, "-") + "-" : "")}${noteItem.parentItem? noteItem.parentItem.getField("citationKey") : ""}.md

Collect note by inputed tags

# This template is specifically for importing/sharing, using better 
# notes 'import from clipboard': copy the content and
# goto Zotero menu bar, click Tools->New Template from Clipboard.  
# Do not copy-paste this to better notes template editor directly.
name: "[item]Collect note by inputed tags"
zoteroVersion: "8.0.3"
pluginVersion: "3.0.2"
savedAt: "2026-03-07T07:36:16.565Z"
content: |-
  // @author windingwind
  // @link https://github.com/windingwind/zotero-better-notes/discussions/236
  // @beforeloop-begin
  ${{
  	const tagRaw = Zotero.getMainWindow().prompt("Please input tags. Split with ',':", "");
  	sharedObj.tags = tagRaw.split(',').filter(t => t.length);
  	return "";
  }}$
  // @beforeloop-end
  // @default-begin
  ${{
  	async function getAnnotationsByTag(item, tag) {
  		let annots = item.getAnnotations();
  		annots = tag.length ?
  			annots.filter((annot) => annot.getTags().map(tagObj => tagObj.tag).includes(tag)) :
  			annots;
  		return await Zotero.BetterNotes.api.convert.annotations2html(annots, { noteItem: targetNoteItem });
  	}
  	if (!sharedObj.tags.length) {
  		return "";
  	}
  	const attachments = Zotero.Items.get(topItem.getAttachments()).filter((i) =>
  		i.isPDFAttachment()
  	);
  	let res = "";
  	res += `<h1>${topItem.getField('title')}</h1>`;
  	for (let attachment of attachments) {
  		res += `<h2>${attachment.getFilename()}</h2>`;
  		for (const tag of sharedObj.tags) {
  			res += `<h3>Tag: ${tag}</h3>`;
  			const annots = (await getAnnotationsByTag(attachment, tag));
  			res += annots ? annots : "<p>No result</p>";
  		}
  	}
  	res += `<h2>Notes</h2>`;
  	const notes = itemNotes.filter(noteItem => {
  		for (const tag of sharedObj.tags) {
  			if (noteItem.getTags().map(tagObj => tagObj.tag).includes(tag)) {
  				return true;
  			}
  		}
  		return false;
  	});
  	const notesWithTags = `${notes.map((noteItem) => {
  		const noteLink = Zotero.BetterNotes.api.convert.note2link(noteItem);
  		const noteLine = `<p style="color:red; background-color: #efe3da;">📜 Article Note:  <a href="${
  				noteLink
  			}">${noteItem.getNoteTitle() || noteLink}</a></p>
  <p>tags: ${noteItem.getTags().map(tagObj => tagObj.tag).join(', ')}</p>
  <p> </p>`;
  		return noteLine;
  	}).join("\n")}`
  	res += notesWithTags || '<p>No result</p>'
  	return res;
  }}$
  // @default-end