[Item] 根据标注标签/颜色自动生成笔记/Generate note from annotations (by tag/color)（2025.4.20更新/updated）

[zhikaiyici]

更新日志

2025.4.20更新： 新增解析标注翻译，翻译内容形式为🔤翻译🔤（Translate for Zotero插件默认）。

2025.3.31更新：

1. 更改样式，取消引用块，评论与标注不分段，评论加粗显示；（可更改getAnnotationsByTag/getAnnotationsByColor函数中result += ...语句将样式更改为引用块，即注释掉现有result += ...语句，并取消注释result += "<blockquote>" + theContent + "</blockquote>" + annoItem.annotationComment;）
2. 拆分模板，解决使用// @use-refresh后标题显示为空，将主模板中runItemTemplate函数的第一个参数更改为不同的子模板名称实现调用不同子模板，如[item]by tag/[item]by color/[item]by brackets tag。

2024.11.21更新： 使用允许内容刷新。（使用后将在笔记开头生成一段“代码”用于更新笔记，如下图所示。如不需要更新笔记请删除模板中// @use-refresh。）

2024.11.18更新： 标注原文格式化为引用块。

2024.11.13更新： 修复未安装Style插件时报错。

2024.11.08更新： 添加按标注颜色生成笔记。

2024.11.07更新： 添加文档超链接。

2024.11.05更新： 只需更改数组变量myAnnotations及其元素即可全局生效。

Description

主模板是必须的，根据需要选择不同的子模板by color、by tag或by brackets tag。将主模板中runItemTemplate函数的第一个参数更改为不同的子模板名称实现调用不同子模板，即[item]by tag/[item]by color/[item]by brackets tag。生成笔记时选择主模板Generate note from annotations。
The main template is mandatory. Choose different sub-templates, i.e., by color, by tag, or by brackets tag, as needed. Change the first parameter of the function runItemTemplate in the main template to a sub-template name, i.e., [item]by tag/[item]by color/[item]by brackets tag, to call a different sub-template. Choose the main template Generate note from annotations when generating a note.

从特定标签/颜色/自定义标签的标注生成笔记，修改于#1101 。
支持中英文条目，支持一个条目下多个附件中（包括PDF、EPUB和Snapshot）注释的提取，支持了除涂鸦类型之外的所有注释类型，移除了标题和摘要翻译。

笔记命名模板为标题(年, 期刊简称, 第一位作者)，笔记正文中显示前10位作者，多于10位作者则截断。

期刊标签功能需要安装Style插件。

使用方法/Usage

根据标注标签生成笔记/Generate a note based on annotation tags

在Zotero阅读器内做标注，并给标注添加标签，如"Background", "Method", "Conclusion", "Innovation", "Shortage", "Problem"等，做完整篇文章的标注并打标签之后，使用从模板新建条目子笔记创建笔记。
After annotating the entire article in the Zotero reader, add tags such as "Background", "Method", "Conclusion", "Innovation", "Shortage", "Problem", etc., and then create a note using "New ltem Note from Template".

根据标注颜色生成笔记/Generate a note based on annotation colors

在Zotero阅读器内做标注，做完整篇文章的标注之后，使用从模板新建条目子笔记创建笔记。
默认颜色红色、绿色、蓝色、紫色、洋红色、橙色，分别对应"Background", "Method", "Conclusion", "Innovation", "Shortage", "Problem"。
After annotating the entire article in the Zotero reader, create a note using "New ltem Note from Template".
The default colors are red, green, blue, purple, magenta, and orange, corresponding to "Background", "Method", "Conclusion", "Innovation", "Shortage", and "Problem", respectively.

修改代码/Modify the template

变量myAnnotations为标注的数组，根据需要修改其中元素的tag/color属性值为自己的标签名称/颜色或者增/减元素。
无论是根据标签还是颜色，tag值和emoji值都会体现在笔记的二级标题中，可以根据需要修改。
myAnnotations中元素的顺序即为笔记中二级标题的顺序。
The variable myAnnotations is the array of annotations. Change the attribute value tag/color of the element to your own tags/colors or add/delete elements as needed.
Whether based on tags or colors, values of and tag and emoji are reflected in the secondary headings of the note and can be modified as needed. The order of the elements in myAnnotations is the order of the secondary headings in the note.

Screenshots

Test on Zotero version

7.0.7

Test on Better Notes version

2.0.12

Template Type

Item

Template Share Code

主模板/Main template：Generate note from annotations

# 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]Generate note from annotations"
zoteroVersion: "7.0.15"
pluginVersion: "2.4.8"
savedAt: "2025-04-20T13:21:28.269Z"
content: |-
  // @author zhikaiyici
  // @link [PUBLISH PAGE URL](https://github.com/windingwind/zotero-better-notes/discussions/1129)
  // @beforeloop-begin
  ${await(async() => {
      // 辅助函数：检测字符串是否包含中文字符
      const containsChinese = (text) => /[\u4e00-\u9fa5]/.test(text);
  
      // 检查标题是否为中文
      let isChineseTitle = containsChinese(items[0].getField("title"));
  
      // 获取作者显示内容
      let creators = items[0].getCreators();
      let authorDisplay = ["", ""];
      if (isChineseTitle) {
          // 中文标题：显示第一作者全名，格式为“姓名”
          if (creators.length > 0) {
              let firstAuthor = creators[0];
              let fullName = firstAuthor.lastName + firstAuthor.firstName;
              if (creators.length > 1) {
                  authorDisplay[0] = fullName + "等";
              }
              else {
                  authorDisplay[0] = fullName;
              }
              // 正文中显示前10位作者，多于10位加等
              if (creators.length > 10) {
                  authorDisplay[1] = creators.splice(0, 10).map((v) => v.firstName + v.lastName).join("; ");
                  authorDisplay[1] = authorDisplay[1] + "等";
              }
              else {
                  authorDisplay[1] = creators.map((v) => v.firstName + v.lastName).join("; ");
              }
          }
      }
      else {
          // 非中文标题：显示第一作者姓氏并附加“et al.”
          if (creators.length > 0) {
              let firstAuthorLastName = creators[0].lastName;
                  if (creators.length > 1) {
                      authorDisplay[0] = `${firstAuthorLastName} et al.`;
                  }
                  else {
                      authorDisplay[0] = creators[0].lastName + " " + creators[0].firstName;
                  }
                  // 正文中显示前10位作者，多于10位加et al.
                  if (creators.length > 10) {
                      authorDisplay[1] = creators.splice(0, 10).map((v) => v.firstName + " " + v.lastName).join("; ");
                      authorDisplay[1] = authorDisplay[1] + "; et al.";
                  }
                  else {
                      authorDisplay[1] = creators.map((v) => v.firstName + " " + v.lastName).join("; ");
                  }
              }
      }
      // 非期刊条目显示论文集、大学、出版社、仓库...
      let otherName = items[0].getField("proceedingsTitle")
          + items[0].getField("university") + items[0].getField("publisher")
          + items[0].getField("repository") + items[0].getField("institution")
          + items[0].getField("meetingName");
      let publicationName = items[0].getField("publicationTitle") + otherName;
      let sourceName = items[0].getField("journalAbbreviation") + otherName;
      
      let res = `
          <h1> ${items[0].getField('title')} (${items[0].getField("year")}, ${sourceName ? sourceName + ", " : ""} ${authorDisplay[0]})</h1>
          <hr/>
          <table>
          <!--<p>-->
          <tr><td style="background-color:#f6f8fa;">
              <b><span style="color: #3c5acc">Author: </span></b> ${authorDisplay[1]}
          </td></tr>
          <!--</p>-->
  
          <!--<p>-->
          <tr><td style="background-color:#ecf3fa;"><b><span style="color: #3c5acc">Source: </span></b>
              ${(items[0].getField("volume") + items[0].getField("issue") + items[0].getField("pages")) ? 
              (publicationName + " (" + 
              (items[0].getField("volume") ? "Volume: " + items[0].getField("volume") + ", " : '') + 
              (items[0].getField("issue") ? "Issue: " + items[0].getField("issue") + ", " : '') + 
              (items[0].getField("pages") ? "Pages: " + items[0].getField("pages") : '') + ")") : publicationName}
              ${(() => {
                  if (Zotero.ZoteroStyle) {
                      let space = " ";
                      return Array.prototype.map.call(
                          Zotero.ZoteroStyle.api.renderCell(items[0], "publicationTags").childNodes,
                          e => {
                              e.innerText = space + e.innerText + space;
                              return e.outerHTML
                          }
                      ).join(space);
                  }
              })()}
          </td></tr>
          <!--</p>-->
  
          <!--<p>-->
          <tr><td style="background-color:#f6f8fa;">
              ${(() => {
                  const doi = items[0].getField("DOI");
                  if (doi) {
                      return `<b><span style="color: #3c5acc">DOI: </span></strong></b> 
                      <a href="https://doi.org/${items[0].getField('DOI')}">${items[0].getField('DOI')}</a>`;
                  } else {
                      return `<b><span style="color: #3c5acc">URL: </span></strong> </b> 
                      <a href="${items[0].getField('url')}">${items[0].getField('url')}</a>`;
                  }
             })()}
          </td></tr>
          <!--</p>-->
  
          <!--<p>-->
          <tr><td style="background-color:#ecf3fa;">
              <b><span style="color: #3c5acc">Date: </span></b> ${items[0].getField('date')}
          </td></tr>
          <!--</p>-->
  
          <!-- 本地链接 -->
          <!--<p>-->
          <tr><td style="background-color:#f6f8fa;">
              ${(() => {
                  const attachments = Zotero.Items.get(items[0].getAttachments());
                  if (attachments && attachments.length > 1) {
                      return `<b><span style="color: #3c5acc">Full Text: </span></b>
                      <a href=zotero://open-pdf/0_${Zotero.Items.get(items[0].getAttachments()).filter((i) => i.isPDFAttachment())[0].key}>
                      ${Zotero.Items.get(items[0].getAttachments()).filter((i) => i.isPDFAttachment())[0].getFilename()}</a>`;
                  } else {
                      if (attachments && attachments.length > 0) {
                          return `<b><span style="color: #3c5acc">Full Text: </span> </b> 
                          <a href="zotero://open-pdf/0_${attachments[0].key}">${attachments[0].getFilename()}</a>`;
                      }
                      else {
                          return `<b><span style="color: #3c5acc">Full Text: </span></b>`;
                      }
                  }
              })()}
          </td></tr>
          <!--</p>-->
  
          <!-- 摘要 -->
          <!--<p>-->
          <tr><td style="background-color:#ecf3fa;">
              <b><span style="color: #3c5acc">Abstract: </span></b> <i>${items[0].getField('abstractNote')}</i>
          </td></tr>
          <!--</p>-->
          </table>
  
          `;
      return res;
  })()}
  
  ${await Zotero.BetterNotes.api.template.runItemTemplate("[item]by color", {
      itemIds: items.map(item=>item.id),
      targetNoteId: targetNoteItem?.id,
      dryRun: _env.dryRun
  })}
  
  // @beforeloop-end
  // @default-begin
  // @default-end

子模板/Sub-template：by color

# 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]by color"
zoteroVersion: "7.0.15"
pluginVersion: "2.4.8"
savedAt: "2025-04-20T13:23:13.193Z"
content: |-
  // @author zhikaiyici
  // @link [PUBLISH PAGE URL](https://github.com/windingwind/zotero-better-notes/discussions/1129)
  // @use-refresh
  ${ await(async() => {
      // 无法提取ink（涂鸦）注释
      const getAnnotationsByColor = async (_item, _color, _annotated) => {
          const annots = _item.getAnnotations().filter((i) => i.annotationColor === _color);
  
          const processAnnotation = async (_annoItem) => {
              const isNoteType = ["note", "text"].includes(_annoItem.annotationType);
              const htmlContent = await Zotero.BetterNotes.api.convert.annotations2html(
                  [_annoItem], 
                  {
                      noteItem: targetNoteItem,
                      ignoreComment: !isNoteType
                  }
              );
  
              const parseComment = (_comment = "") => {
                  const parsed = _comment.match(/^(.*?)🔤(.*?)🔤(.*?)$/s);
                  return parsed ? {comment: parsed[1].trim() + parsed[3].trim(), translation: `🔤${parsed[2].trim()}🔤`} : { comment: _comment.trim(), translation: "" };
              };
  
              if (!isNoteType) {
                  const parsedComment = parseComment(_annoItem.annotationComment || "");
                  // 不将标注格式化为引用块，标注和评论不分段，并加粗评论，评论在标注后
                  return htmlContent.replace("</p>", parsedComment ? `${parsedComment.translation ? "<br>" + parsedComment.translation: ""}${parsedComment.comment ? "<br><b>" + parsedComment.comment + "</b>" : ""}</p>` : "</p>");
                  // 不将标注格式化为引用块，标注和评论不分段，并加粗评论，评论在标注前
                  // return htmlContent.replace("<p>", parsedComment ? `<p>${parsedComment.comment ?  "<b>" + parsedComment.comment + "</b><br>" : ""}${parsedComment.translation ? parsedComment.translation + "<br>": ""}` : "<p>");
                  // 将标注格式化为引用块，标注和评论分段，评论在标注后
                  // return "<blockquote>" + htmlContent.replace("</p>", parsedComment.translation ? "<br>" + parsedComment.translation + "</p>" : "</p>") + "</blockquote>" + parsedComment.comment;
              
              }
              return htmlContent;
          };
  
          const results = await Promise.all(annots.map(processAnnotation));
          let content = results.join("");
  
          if (_annotated > 1 && content) {
              const docTitle = _item.getField("title");
              const docLink = `zotero://open-pdf/0_${_item.key}`;
              content = `<h3>📄For Document: <a href="${docLink}">${docTitle}</a></h3>${content}`;
          }
  
          return content;
      };
  
      let background = { value: "", tag: "Background", emoji: "🌏", color: "#ff6666" }; // general.red
      let method = { value: "", tag: "Method", emoji: "🔬", color: "#5fb236" }; // general.green
      let conclusion = { value: "", tag: "Conclusion", emoji: "📜", color: "#2ea8e5" }; // general.blue
      let innovation = { value: "", tag: "Innovation", emoji: "💡", color: "#a28ae5" }; // general.purple
      let shortage = { value: "", tag: "Shortage", emoji: "🚩", color: "#e56eee" }; // general.magenta
      let question = { value: "", tag: "Problem", emoji: "❓", color: "#f19837" }; // general.orange
      let myAnnotations = [background, method, conclusion, innovation, shortage, question];
      const attachments = Zotero.Items.get(topItem.getAttachments()).filter((i) => i.isPDFAttachment() || i.isSnapshotAttachment() || i.isEPUBAttachment());
      let annotatedAttachment = 0;
      for (let attachment of attachments) {
          if (attachment.getAnnotations().length > 0)
              annotatedAttachment++; 
      }
  
      await Promise.all(myAnnotations.map(async (myAnnotation) => {
          const annotationsPromises = attachments.map((attachment) => getAnnotationsByColor(attachment, myAnnotation.color, annotatedAttachment));
          const renderedAnnotationsArray = await Promise.all(annotationsPromises);
          const renderedAnnotations = renderedAnnotationsArray.filter(Boolean).join("");
          if (renderedAnnotations) {
              myAnnotation.value = renderedAnnotations;
          }
      }));
  
      let res = `
  
          <!-- 生成标签笔记 -->
  
          ${(() => {
              let res = "";
              for (let myAnnotation of myAnnotations) {
                  res += myAnnotation.value ? `<h2><span style="color: #be1b41">${myAnnotation.emoji + myAnnotation.tag}：</span></h2>${myAnnotation.value}` : '';
              }
              return res;
          })()}
  
      `;
      return res;        
  })()}

子模板/Sub-template：by tag

# 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]by tag"
zoteroVersion: "7.0.15"
pluginVersion: "2.4.8"
savedAt: "2025-04-20T13:23:58.671Z"
content: |-
  // @author zhikaiyici
  // @link [PUBLISH PAGE URL](https://github.com/windingwind/zotero-better-notes/discussions/1129)
  // @use-refresh
  ${ await(async() => {
      // 无法提取ink（涂鸦）注释
      const getAnnotationsByTag = async (_item, _tag, _annotated) => {
          let annots = _item.getAnnotations().filter((i) => i.getTags().map((tagObj) => tagObj.tag).includes(_tag));;
          const processAnnotation = async (_annoItem) => {
              const isNoteType = ["note", "text"].includes(_annoItem.annotationType);
              const htmlContent = await Zotero.BetterNotes.api.convert.annotations2html(
                  [_annoItem], 
                  {
                      noteItem: targetNoteItem,
                      ignoreComment: !isNoteType
                  }
              );
  
              const parseComment = (_comment = "") => {
                  const parsed = _comment.match(/^(.*?)🔤(.*?)🔤(.*?)$/s);
                  return parsed ? {comment: parsed[1].trim() + parsed[3].trim(), translation: `🔤${parsed[2].trim()}🔤`} : { comment: _comment.trim(), translation: "" };
              };
  
              if (!isNoteType) {
                  const parsedComment = parseComment(_annoItem.annotationComment || "");
                  // 不将标注格式化为引用块，标注和评论不分段，并加粗评论，评论在标注后
                  return htmlContent.replace("</p>", parsedComment ? `${parsedComment.translation ? "<br>" + parsedComment.translation: ""}${parsedComment.comment ? "<br><b>" + parsedComment.comment + "</b>" : ""}</p>` : "</p>");
                  // 不将标注格式化为引用块，标注和评论不分段，并加粗评论，评论在标注前
                  // return htmlContent.replace("<p>", parsedComment ? `<p>${parsedComment.comment ?  "<b>" + parsedComment.comment + "</b><br>" : ""}${parsedComment.translation ? parsedComment.translation + "<br>": ""}` : "<p>");
                  // 将标注格式化为引用块，标注和评论分段，评论在标注后
                  // return "<blockquote>" + htmlContent.replace("</p>", parsedComment.translation ? "<br>" + parsedComment.translation + "</p>" : "</p>") + "</blockquote>" + parsedComment.comment;
              
              }
              return htmlContent;
          };
  
          const results = await Promise.all(annots.map(processAnnotation));
          let content = results.join("");
  
          if (_annotated > 1 && content) {
              const docTitle = _item.getField("title");
              const docLink = `zotero://open-pdf/0_${_item.key}`;
              content = `<h3>📄For Document: <a href="${docLink}">${docTitle}</a></h3>${content}`;
          }
  
          return content;
      };
  
      let background = { value: "", tag: "Background", emoji: "🌏" };
      let method = { value: "", tag: "Method", emoji: "🔬" };
      let conclusion = { value: "", tag: "Conclusion", emoji: "📜" };
      let innovation = { value: "", tag: "Innovation", emoji: "💡" };
      let shortage = { value: "", tag: "Shortage", emoji: "🚩" };
      let question = { value: "", tag: "Problem", emoji: "❓" };
      let myAnnotations = [background, method, conclusion, innovation, shortage, question];
      const attachments = Zotero.Items.get(topItem.getAttachments()).filter((i) => i.isPDFAttachment() || i.isSnapshotAttachment() || i.isEPUBAttachment());
      let annotatedAttachment = 0;
      for (let attachment of attachments) {
          if (attachment.getAnnotations().length > 0)
              annotatedAttachment++; 
      }
  
      await Promise.all(myAnnotations.map(async (myAnnotation) => {
          const annotationsPromises = attachments.map((attachment) => getAnnotationsByTag(attachment, myAnnotation.tag, annotatedAttachment));
          const renderedAnnotationsArray = await Promise.all(annotationsPromises);
          const renderedAnnotations = renderedAnnotationsArray.filter(Boolean).join("");
          if (renderedAnnotations) {
              myAnnotation.value = renderedAnnotations;
          }
      }));
  
      let res = `
  
          <!-- 生成标签笔记 -->
  
          ${(() => {
              let res = "";
              for (let myAnnotation of myAnnotations) {
                  res += myAnnotation.value ? `<h2><span style="color: #be1b41">${myAnnotation.emoji + myAnnotation.tag}：</span></h2>${myAnnotation.value}` : '';
              }
              return res;
          })()}
  
      `;
      return res;        
  })()}

子模板/Sub-template：by brackets tag （使用方法见/ For usage, refer to https://github.com//discussions/1202）

# 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]by brackets tag"
zoteroVersion: "7.0.15"
pluginVersion: "2.4.8"
savedAt: "2025-04-20T13:24:19.382Z"
content: |-
  // @author zhikaiyici
  // @link [PUBLISH PAGE URL](https://github.com/windingwind/zotero-better-notes/discussions/1202)
  // @use-refresh
  ${ await(async() => {
      const getAnnotationLabelsAndComment = (_annotation) => {
          let result = { labels: [], sectionComment: "", translation: "" };
          let _comment = _annotation.annotationComment || "";
          let _tag = _annotation.getTags().map((tagObj) => tagObj.tag).join();
          let parsed = _comment.match(/^(.*?)🔤(.*?)🔤(.*?)$/s)
          if (parsed) {
              result.translation = "🔤" + parsed[2].trim() + "🔤";
              _comment = parsed[1].trim() + parsed[3].trim();;
          }
          parsed = _comment.match(/^\[(.*?)\](.*)/s);
          if (!parsed) {
              if (_tag.includes("Figure")) {
                  result.labels.push("Figures");
              }
              else if (_tag.includes("Table")) {
                  result.labels.push("Tables");
              }
              else {
                  result.labels.push("Unlabeled");
              }
              result.sectionComment = _comment;
          }
          else {
              while (parsed) {
                  result.labels.push(parsed[1].trim());
                  result.sectionComment = parsed[2].trim();
                  parsed = result.sectionComment.match(/^\[(.*?)\](.*)/);
              }
          };
          return result;
      }
  
      const colors = [
          ["#1565C0", "#E1F5FE"],
          ["#006064", "#E0F7FA"],
          ["#2E7D32", "#F1F8E9"],
          ["#E65100", "#FFF8E1"],
          ["#4A148C", "#F5F5F5"]
      ];
  
      const processAnnotations = (grouped, parentLevel) => {
          let result = "";
          let i = 0;
          // 遍历每个组
          for (const label in grouped) {
              if (label != "Unlabeled" && label != "Figures" && label != "Tables") {
                  i++;
                  const group = grouped[label];
                  let color = colors[group.level - 2] ? colors[group.level - 2]:["",""];//["#000000", "#FFFFFF"];
                  const heading = `<h${group.level} style="color:${color[0]}; background-color:${color[1]}">${(parentLevel ? parentLevel : "") + i + " " + label}</h${group.level}>`;
                  result = `${result}${heading}${group.content.filter(Boolean).join("")}`; // + "\n";
                  // 递归处理子标签
                  if (group.childLabels)
                      result = `${result}${processAnnotations(group.childLabels, (parentLevel ? parentLevel : "") + i + ".")}`;
              }
          }
          for (const label in grouped) {
              if (label === "Figures") {
                  i++;
                  const group = grouped[label];
                  const color = colors[0] ? colors[0]:["",""];
                  const heading = `<h${group.level}  style="color: ${color[0]}; background-color: ${color[1]}">${(parentLevel ? parentLevel : "") + i + " " + label}</h${group.level}>`;
                  result = `${result}${heading}${group.content.filter(Boolean).join("")}`; // + "\n";
                  break;
              }
          }
          for (const label in grouped) {
              if (label === "Tables") {
                  i++;
                  const group = grouped[label];
                  const color = colors[0] ? colors[0]:["",""];
                  const heading = `<h${group.level}  style="color: ${color[0]}; background-color: ${color[1]}">${(parentLevel ? parentLevel : "") + i + " " + label}</h${group.level}>`;
                  result = `${result}${heading}${group.content.filter(Boolean).join("")}`; // + "\n";
                  break;
              }
          }
          for (const label in grouped) {
              if (label === "Unlabeled") {
                  i++;
                  const group = grouped[label];
                  const color = colors[0] ? colors[0]:["",""];
                  const heading = `<h${group.level}  style="color: ${color[0]}; background-color: ${color[1]}">${(parentLevel ? parentLevel : "") + i + " " + label}</h${group.level}>`;
                  result = `${result}${heading}${group.content.filter(Boolean).join("")}`; // + "\n";
                  break;
              }
          }
          return result;
      }
  
      let myAnnotations = "";
      const attachments = Zotero.Items.get(topItem.getAttachments()).filter((i) => i.isPDFAttachment() || i.isSnapshotAttachment() || i.isEPUBAttachment());
      let annotatedAttachment = 0;
      for (let attachment of attachments) {
          if (attachment.getAnnotations().length > 0)
              annotatedAttachment++; 
      }
  
      let groupedAnnotations = {};
      const processedAnnotations = await Promise.all(
          attachments.map((attachment, attachmentIndex) => {
              const title = `<i>📄For Document: <a href="zotero://open-pdf/0_${attachment.key}">${attachment.getField("title")}</a></i>`;
  
              return Promise.all(
                  attachment.getAnnotations().map(async (annoItem, annotIndex) => {
                      const isNoteType = ["note", "text"].includes(annoItem.annotationType);
                      const {labels, sectionComment, translation} = getAnnotationLabelsAndComment(annoItem);
          
                      const theContent = await Zotero.BetterNotes.api.convert.annotations2html(
                          [annoItem], 
                          { noteItem: targetNoteItem, ignoreComment: !isNoteType }
                      );
  
                      return {
                          attachmentIndex,
                          annotIndex,
                          title,
                          labels,
                          processedContent: formatContent(theContent, labels, isNoteType, sectionComment, translation)
                      };
                  })
              );
          })
      );
  
      processedAnnotations.flat().sort((a, b) => {
          const attachOrder = a.attachmentIndex - b.attachmentIndex;
          return attachOrder !== 0 ? attachOrder : a.annotIndex - b.annotIndex;
      }).forEach(({labels, title, processedContent}) => {
          let currentLevel = groupedAnnotations;
          labels.forEach((label, index) => {
              currentLevel = currentLevel[label] ||= {
                  level: index + 2,
                  content: [],
                  childLabels: {}
              };
  
              if (index === labels.length - 1) {
                  const shouldAddTitle = annotatedAttachment > 1 && !currentLevel.content.some(t => t === title);
                  currentLevel.content.push(...(shouldAddTitle ? [title, processedContent] : [processedContent]));
              } else {
                  currentLevel = currentLevel.childLabels;
              }
          });
      });
  
      function formatContent(_content, _labels, _isNoteType, _comment, _translation) {
          // 不将标注格式化为引用块，标注和评论不分段，并加粗评论，评论在标注后
          return _isNoteType ? _content.replace(`[${_labels.join('][')}]`, "") : _content.replace("</p>", (_comment + _translation) ? `${_translation ? "<br>" + _translation : ""}${_comment ? "<br><b>" + _comment + "</b>" : ""}</p>` : "</p>");
          // 不将标注格式化为引用块，标注和评论不分段，并加粗评论，评论在标注前
          // return _isNoteType ? _content.replace(`[${_labels.join('][')}]`, "") : _content.replace("<p>", (_comment + _translation) ? `<p>${_comment ? "<b>" + _comment + "</b><br>" : ""}${_translation ? _translation + "<br>" : ""}` : "<p>");
          // 将标注格式化为引用块，标注和评论分段，评论在标注后
          // return _isNoteType ? _content.replace(`[${_labels.join('][')}]`, "") : "<blockquote>" + _content.replace("</p>", _translation ? "<br>" + _translation + "</p>" : "</p>") + "</blockquote>" + _comment;
  
      }
      myAnnotations += processAnnotations(groupedAnnotations) ? processAnnotations(groupedAnnotations) : "";
  
     	let res = `
          <!-- 生成标签笔记 -->
          ${myAnnotations}`;
      return res;        
  })()}

Anything else

可安装Action插件并配合根据标注颜色自动添加标签动作使用。

/**
 * 注释：根据注释颜色增加标签
 * @author appwcn windingwind
 * @link https://github.com/windingwind/zotero-actions-tags/discussions/339
 */

// EDTI TAG MAPPING BELOW
const tags = {
    "#ff6666": "背景", // general.red
    "#5fb236": "方法", // general.green
    "#2ea8e5": "结论", // general.blue
    "#a28ae5": "创新", // general.purple
    "#e56eee": "不足", // general.magenta
    "#f19837": "问题", // general.orange
}

if (!item) {
    return; // "No item provided.";
}

if (!item.isAnnotation() || !item.annotationColor) {
    return "Not an annotation or no color.";
}

const newTag = tags[item.annotationColor];

const existingTags = item.getTags().map(tag => tag.tag); 
let removedTags = [];
const allTags = Object.values(tags);
for (const tag of existingTags) {
    if (allTags.includes(tag)) {
        item.removeTag(tag);
        removedTags.push(tag);
    }
}

if (newTag) {
    item.addTag(newTag);
    if (removedTags.length > 0) {
        return `Tag removed: ${removedTags.join(", ")} | Tag added: ${newTag}`;
    } else {
        return `Tag added: ${newTag}`;
    }
} else {
    if (removedTags.length > 0) {
        return `Tag removed: ${removedTags.join(", ")} | Undefined tag color: ${item.annotationColor}`;
    } else {
        return `Undefined tag color: ${item.annotationColor}`;
    }
}

可安装Style插件实现自定义标注颜色和名称。

[Lix-2241]

麻烦请教一下大佬，我的复制之后标签标注不显示，文字标注在颜色部分的后面，该如何操作呢

[zhikaiyici]

我没明白你描述的问题，这个模板和标注的颜色没有关系，只和标注的标签有关

[Lix-2241]

以您的第一个图片为例子，我的文字标注出现在黄色部分后面，我想让他出现在前面以便做一个文字评论部分的思维导图。

[zhikaiyici]

我大概明白了，你是想把标注的评论放在标注本身的前面，这需要改写getAnnotationsByTag函数，把标注文本和标注评论分开处理，并不是这个模板想要实现的功能。

[zhikaiyici]

已过时。

**2024.11.7更新：** 保留下划线类型标注的超链接，标注内容格式化为引用块。 改了一下`getAnnotationsByTag`函数，把原模板中的`getAnnotationsByTag`函数用下面的代码代替应该能达到你想要的效果。 ```javascript const getAnnotationsByTag = async (_item, _tag) => { let annots = _item.getAnnotations(); let result = ""; for (let annoItem of annots) { //if (annoItem.getTags().find((i) => i.tag.includes(tag))) { if (annoItem.getTags().map((tagObj) => tagObj.tag).includes(_tag)) { if (["note", "text", "highlight", "underline"].includes(annoItem.annotationType)) { let myComment = ""; if(["highlight", "underline"].includes(annoItem.annotationType) && annoItem.annotationComment){ myComment = annoItem.annotationComment; result += myComment; annoItem.annotationComment = ""; } const res = Zotero.EditorInstanceUtilities.serializeAnnotations([{ ...(await Zotero.Annotations.toJSON(annoItem)), ...{ attachmentItemID: annoItem.parentID } }]); if (["note", "text"].includes(annoItem.annotationType)) result += res.html; else result += "

" + res.html + "

"; if (myComment) annoItem.annotationComment = myComment; } else { if (annoItem.annotationComment) //result += await Zotero.BetterNotes.api.convert.md2html(annoItem.annotationComment); result += annoItem.annotationComment; //if (["image", "ink"].includes(annoItem.annotationType)) { result += "

" + await Zotero.BetterNotes.api.convert.annotations2html([annoItem], { noteItem: targetNoteItem, ignoreComment: true }) + "

"; //} } } } return result; }; ```

[Lix-2241]

哦，谢谢大佬！

[zzw-010306]

Template Preview Error: Error: getAttachments() cannot be called onattachment items
请问大佬，这种问题要怎么解决呢

[zhikaiyici]

选中条目，不要选中附件

[Murasaki-Shikibu]

感谢大佬分享，话说可以麻烦大佬粘贴一个傻瓜式的代码，可以复制粘贴即用的吗？我粘贴了大佬的代码，笔记里完全用不了，显示error

[jiapingshiliu]

添加了标注之后还需要再添加tags 能不能直接标注颜色默认分类标签生成笔记

[zhikaiyici]

已过时。

稍作改动就可以，用下面的代码替换原模板中的对应部分。 ```javascript const getAnnotationsByColor = async (_item, _color) => { //let annots = _item.getAnnotations().filter((i) => i.annotationColor === _color); let annots = _item.getAnnotations(); let result = ""; for (let annoItem of annots) { if (annoItem.annotationColor === _color) { if (annoItem.annotationType != "image" && annoItem.annotationType != "ink") { // 无法提取框选注释图片，仅能获取其备注文字 const res = Zotero.EditorInstanceUtilities.serializeAnnotations( [ { ...(await Zotero.Annotations.toJSON(annoItem)), ...{ attachmentItemID: annoItem.parentID } } ] ); result += res.html; //result += "zotero API " + annoItem.annotationType; } else { // 无法提取下划线注释和文字批注 const res = await Zotero.BetterNotes.api.convert.annotations2html([annoItem], { noteItem: targetNoteItem }); result += res; //result += " better notes API " + annoItem.annotationType; } } } return result; };

let background = { value: "", tag: "背景", emoji: "🌏", color: "#ff6666" }; // general.red
let method = { value: "", tag: "方法", emoji: "🔬", color: "#5fb236" }; // general.green
let conclusion = { value: "", tag: "结论", emoji: "📜", color: "#2ea8e5" }; // general.blue
let innovation = { value: "", tag: "创新", emoji: "💡", color: "#a28ae5" }; // general.purple
let shortage = { value: "", tag: "不足", emoji: "🚩", color: "#e56eee" }; // general.magenta
let question = { value: "", tag: "问题", emoji: "❓", color: "#f19837" }; // general.orange
let myAnnotations = [background, method, conclusion, innovation, shortage, question];
const attachments = Zotero.Items.get(topItem.getAttachments()).filter((i) => i.isPDFAttachment() || i.isSnapshotAttachment() || i.isEPUBAttachment());
for (let attachment of attachments) {
    for (var i = 0; i < myAnnotations.length; i++) {
        const annots = await getAnnotationsByColor(attachment, myAnnotations[i].color);
        myAnnotations[i].value += annots ? 
        `<h3>📄For Document: <a href="zotero://open-pdf/0_${attachment.key}">${attachment.getField("title")}</a></h3>` + annots : "";
    }
}

</details>

[221218s]

烦问大佬，我笔记导出markdown为什么标注显示是红色的？

[221218s]

导出到obsidian之后，文字前后的代码是这样的

[windingwind]

你在源码编辑模式自然是有代码高亮的，开阅读模式就“正常”了

[221218s]

不是，就是第一张图那个正文的字是红色的，需要在哪里改一下，让它导出来正文的字不是红色的

[windingwind]

你自己设置了字体红色的笔记样式，怎么设置的怎么改回去就行

[221218s]

找到原因了，是ob的主题色我设置了红色，链接也显示主题色。麻烦您了！

[Sandeul0320]

求问大佬，如果借助Zotero Style的标注功能在默认的高亮颜色基础上增加了其他高亮颜色，要想显示这些新增高亮颜色的标注应该怎么修改代码呢？我只将下面代码中的let xxx、 tag、color属性值改成了自己设置的高亮颜色和颜色对应的名字（共用了10个颜色），并将myAnnotations数组中的元素进行了对应的修改，请问还需要修改哪些地方才能实现我的目的呢？

  let background = { value: "", tag: "背景", emoji: "🌏", color: "#ff6666" }; // general.red
  let method = { value: "", tag: "方法", emoji: "🔬", color: "#5fb236" }; // general.green
  let conclusion = { value: "", tag: "结论", emoji: "📜", color: "#2ea8e5" }; // general.blue
  let innovation = { value: "", tag: "创新", emoji: "💡", color: "#a28ae5" }; // general.purple
  let shortage = { value: "", tag: "不足", emoji: "🚩", color: "#e56eee" }; // general.magenta
  let question = { value: "", tag: "问题", emoji: "❓", color: "#f19837" }; // general.orange
  let myAnnotations = [background, method, conclusion, innovation, shortage, question];

[zhikaiyici]

只改这里就可以了。
比如说你要增加一个颜色，就定义一个对象let result = { value: "", tag: "结果", emoji: "", color: "#ffd400" };，定义好新的对象之后，添加到myAnnotations中，let myAnnotations = [background, method, conclusion, innovation, shortage, question, result ];，就可以了。
注意myAnnotations中元素的顺序就是笔记中的顺序。

[Sandeul0320]

大佬不好意思，还是不太行。我之前也是按您说的方法把定义了新增颜色的对象，并在myAnnotations数组中进行了添加，但用模板生成标注笔记时只有zotero默认高亮颜色（8种：红、橙、黄、绿、蓝、紫、品红、灰）的标注能被导出，我新增的两种高亮颜色标注不能被导出。我修改的部分代码如下，请教大佬该怎么解决这个问题呢？
let abstract = { value: "", tag: "摘要 Abstract", emoji: "🎓", color: "#ffd400" }; // general.yellow
let introduction = { value: "", tag: "前言 Introduction", emoji: "🌏", color: "#f19837" }; // general.orange
let method = { value: "", tag: "材料和方法 Materials and Methods", emoji: "🧪", color: "#5fb236" }; // general.green
let result = { value: "", tag: "结果 Result", emoji: "📊", color: "#2ea8e5" }; // general.blue
let discussion = { value: "", tag: "讨论 Discussion", emoji: "✒️", color: "#a28ae5" }; // general.purple
let conclusion = { value: "", tag: "结论和展望 Conclusion", emoji: "📜", color: "#e56eee" }; // general.magenta
let question = { value: "", tag: "问题 Question", emoji: "❓", color: "#ff6666" }; // general.red
let book = { value: "", tag: "图书 Book", emoji: "📚", color: "#F37A8D" }; // 图书 Book
let innovation = { value: "", tag: "创新 Innovation", emoji: "💡", color: "#0EEAE6" }; // 创新 Innovation
let shortage = { value: "", tag: "不足 Shortage", emoji: "🚩", color: "#aaaaaa" }; // general.grey
let myAnnotations = [abstract, introduction, method, result, discussion, conclusion, question, book, innovation, shortage];

[Sandeul0320]

[zhikaiyici]

颜色编码应该是小写字母我记得

[Sandeul0320]

多谢大佬！现在可以了，这么小的问题真的打扰了😖

[wulizhiren]

作者你好，请问这个模板能实现更新吗？比如我先用模板创建了一个笔记，但我又加了几个带tag的注释，能否不用重新创建笔记实现对这些注释的更新

[windingwind]

如我所说，因为用了分割线语法的缘故

[wulizhiren]

如我所说，因为用了分割线语法的缘故

确实如此，把分割线语法去掉就好了😀，谢谢大佬指导

[franco-ye]

大佬大佬 有自动更新的版本了吗

[2025tr]

能否自动更新？比如标记后，自动刷新模板？

[windingwind]

能否自动更新？比如标记后，自动刷新模板？

请配合actions插件创建动作来实现

[liu1997-wen]

请问为什么后面没有？我是按照把代码粘贴复制过去的e

[zhikaiyici]

@franco-ye

大佬大佬 有自动更新的版本了吗

模板开头加上// @use-refresh，并将模板中两处分割线<hr/>去掉。

[franco-ye]

感谢大佬！出现了类似的信息，但是我添加标注后并没有在笔记中出现？

[franco-ye]

已解决！多谢佬们的贡献

[Infinemen]

请问你是如何解决的，我也遇到类似问题，谢谢。

[zhikaiyici]

请问你是如何解决的，我也遇到类似问题，谢谢。

这是正常的，请看这里

[silviapazzi]

Hi, I have the same issue. I am using the template "Item" "By tag" but I only see the reference without the annotation. Here are some screenshots. I would like to get the annotation tagged as "#resilience: definition". Could you please help me in solving this issue?

#1129

[zhikaiyici]

@windingwind 请问使用自动更新后出现这段信息正常的吗？

感谢大佬！出现了类似的信息，但是我添加标注后并没有在笔记中出现？

[franco-ye]

有没有可能通过action plugin实现自动更新呢

[windingwind]

正常的

[mhh666454]

大佬你好请问H1部分怎么把英文摘要这一块换成中文摘要翻译，或者加入中文摘要翻译

[Susu20241010]

我尝试了一下 把文字高亮成 黄色、洋红色和红色，分别标记为 问题 不足和背景，怎么右边笔记区 没有出现文字，只有原文的内容

[Susu20241010]

你要在条目下根据模板生成笔记

好的 我去试试，

[Susu20241010]

还有个问题 我导入了2条代码：by color和by tag的，是不是只用选by tag的就好了？

[zhikaiyici]

大佬你好请问H1部分怎么把英文摘要这一块换成中文摘要翻译，或者加入中文摘要翻译

看这里#1202 (reply in thread)

[Susu20241010]

我试了 还是不行

[02Zona]

你好，请问遇到这种情况需要如何处理？

[zhikaiyici]

选择条目，不要选择附件。

[LuoW-02]

还是有点没明白这句话，可以麻烦佬解释一下吗，我还是像上面一样显示的很奇怪

[zhikaiyici]

还是有点没明白这句话，可以麻烦佬解释一下吗，我还是像上面一样显示的很奇怪

哪里奇怪，带图说话，截图范围大一点，以及说明你是如何操作的。

[Lightning-w]

你好，可以让多个颜色对应一个二级标题吗

[zhikaiyici]

可以，但是没必要。你可以用by tag模板，by tag模板只和标注的标签有关，和颜色无关。
或者用by brackets tag模板，完全自定义标题，也可以实现多级标题。

[ease-zh]

不支持更新笔记吗？

[zhikaiyici]

2024.11.21更新： 使用允许内容刷新。

支持。

[ddin13]

想问问大佬能不能 把 生成的背景、结论、方法等 标题行增加background-color呢？

[zhikaiyici]

有个性化定制样式的需求建议了解一下HTML。下面是一个表格和定义文字背景颜色的例子。

1行1列	1行2列
2行1列	2行2列

标题1

<table>
    <tr>
        <td style="background-color:#f3faf4;">1行1列</td>
        <td style="background-color:#f3faf4;">1行2列</td>
    </tr>
    <tr>
        <td style="background-color:#f3faf4;">2行1列</td>
        <td style="background-color:#f3faf4;">2行2列</td>
    </tr>
</table>

<h1 style="color:#2e7d32; background-color: #dbeedd">标题1</h1>

[ddin13]

谢谢您！想问问自定义的代码 是直接插入源代码的后面吗？还是替代哪些源代码呢？非常感谢！🥹

[zhikaiyici]

谢谢您！想问问自定义的代码 是直接插入源代码的后面吗？还是替代哪些源代码呢？非常感谢！🥹

修改let res = 后面的部分。
去掉不必要的段落标签<p></p>等，按照你的需求在相应位置添加表格控制标签和相应的样式属性控制。
标题背景色修改<!-- 生成标签笔记 -->下面的代码块内的HTML标签的属性。

[lllMcNultylll]

背景颜色同理

[happy0zr]

背景颜色同理

多谢回复，按你的思路+GPT询问搞了半天搞定了标题🤦🏻‍♀️，实在太小白了，自动链接的笔记部分实在不知道改哪里，我还是手动吧😅

[ddin13]

能生成翻译的摘要吗？

[zhikaiyici]

看这里#1202 (reply in thread)

[ddin13]

非常感谢！

[Kakei08]

您好，不好意思给您添麻烦了，我按照教程重新整理了自己的tag和标注还有color后发现，创建笔记只能创建开头的部分，我标注的部分不会自动添加到笔记里，请问是代码哪里出现逻辑问题了呢？

这是我color代码的部分，tag里我是直接复制并删除了color部分的颜色代码
let introduction = { value: "", tag: "前言", emoji: "🌏", color: "#ffd95f" }; // general.orange let Literature Review = { value: "", tag: "现有文献综述", emoji: "📓", color: "#e1eebc" }; // general.green let critique = { value: "", tag: "现有文献批判", emoji: "📒", color: "#90c67c" }; // general.blue let shortage = { value: "", tag: "文献空白", emoji: "⭕", color: "#489c17" }; let rationable = { value: "", tag: "理论依据", emoji: "✒️", color: "#67ae6e" }; // general.purple let Results Conclusion with Literature = { value: "", tag: "现有文献一致点", emoji: "✅", color: "#d1f8ef" }; let Results to The Contrary = { value: "", tag: "现有文献相反点", emoji: "❎", color: "#189ab4" }; let conclusion = { value: "", tag: "研究结果", emoji: "📜", color: "#ff6363" }; // general.magenta let What They Did = { value: "", tag: "结论", emoji: "📝", color: "#ec7fa9" }; // general.red let Point of Critique = { value: "", tag: "批评点", emoji: "✍️", color: "#efd8f4" }; let Missed Obvious Point = { value: "", tag: "遗漏点", emoji: "🤏", color: "#d4abdc" }; let Relevant Point to Pursue = { value: "", tag: "待探讨相关问题", emoji: "❓", color: "#8b76a5" }; let Will = { value: "", tag: "能否", emoji: "💡", color: "#b9c0d5" }; let myAnnotations = [introduction, Literature Review, critique, shortage, rationable, Results Conclusion with Literature, Results to The Contrary, conclusion, What They Did, Point of Critique, Missed Obvious Point, Relevant Point to Pursue, Will ]; const attachments = Zotero.Items.get(topItem.getAttachments()).filter((i) => i.isPDFAttachment() || i.isSnapshotAttachment() || i.isEPUBAttachment());

[zhikaiyici]

变量名不可以是Results Conclusion with Literature这样的多个单词，变量名内不可以有除字母数字下划线之外的字符，且不能以数字开头，改成类似Results_Conclusion_with_Literature或者把空格删掉，基本所有的编程语言都遵循这个规则。

[Kakei08]

原来如此，感觉自己学到了好多！我是一名文科生，第一次接触编程的内容，您提供的模板真的让人效率很高，特别特别感谢您！

[zikebinbleu]

大佬，你好！我成功设置了主模板和子模板by color之后，在生成主模板笔记的时候会有一段文字在中间（如图），请问这个能怎么消除呢？

[zhikaiyici]

看“2024.11.21更新：……”，这是用来更新笔记的。也就是生成笔记之后，如果又在文章中添加了新的标注，不必删除旧笔记，只需要更新就可以。

[zikebinbleu]

感谢大佬回复。了解这个是更新笔记用的，也的确有自动更新笔记的需求。

[FireflyZJY-Jim]

大佬你好，我是小白，我想问一下这个主模板和子模板是要怎么复制到，zotero的模板编辑器里啊？是把子模板直接复制到主模板的代码下面吗？还是要新建两个条目，一个是主模板的代码一个是子模板的代码？

真的研究很长时间，但是还是没太搞懂。麻烦大佬解答了，谢谢！

[zhikaiyici]

导入两个模板，然后生成笔记的时候调用主模板，你截图那样没错。

[363OneW]

请问，知不知道为什么使用“从剪切板导入”功能时，zotero 直接卡死退出了

[zhikaiyici]

更新插件/软件/重启，和模板应该没关系

[zhikaiyici]

@silviapazzi

1. You need to modify the code sub-template by tag. Change the members of the variable myAnnotations to your own tags. For example,

    let definition = { value: "", tag: "#resilience: definition", emoji: "🌏" };
    let yourTag2 = { value: "", tag: "yourTag2", emoji: "🔬" };
    let yourTag3 = { value: "", tag: "yourTag3", emoji: "📜" };
    let myAnnotations = [definition, yourTag2, yourTag3];

2. Modify the main template Generate note from annotations. Change the first parameter of function Zotero.BetterNotes.api.template.runItemTemplate, in your case, to [item]by tag.
3. Generate note from main template Generate note from annotations, not the sub-template.

Let me know if anything is unclear.

[silviapazzi]

Thank you so much! It works!

[yaowei-520]

大佬们，我是小白，完全不怎么懂，主程序和子程序是这样连接到一块的嘛？

[zhikaiyici]

不是的，你要用哪个子模板就改成哪个，比如你要用by tag，那就把原来的[Item]by color改成[Item]by tag，而不是把所有的子模板都填上去。

我在说明里这么写有什么歧义吗？请反馈，我改一下。

主模板是必须的，根据需要选择不同的子模板by color、by tag或by brackets tag。将主模板中runItemTemplate函数的第一个参数更改为不同的子模板名称实现调用不同子模板，即[item]by tag/[item]by color/[item]by brackets tag。生成笔记时选择主模板Generate note from annotations。

[yaowei-520]

谢谢谢谢。这里没有问题，是我理解错了。之前理解的是主模板+三个子模板-这样才是完整的。当时还有疑问，为什么子模板要分三个写，原来是不同的功能。哈哈

…

---- 回复的原邮件 ---- | 发件人 | ***@***.***> | | 日期 | 2025年05月20日 14:02 | | 收件人 | ***@***.***> | | 抄送至 | ***@***.***>***@***.***> | | 主题 | Re: [windingwind/zotero-better-notes] [Item] 根据标注标签/颜色自动生成笔记/Generate note from annotations (by tag/color)（2025.4.20更新/updated） (Discussion #1129) | 不是的，你要用哪个子模板就改成哪个，比如你要用by tag，那就把原来的[Item]by color改成[Item]by tag，而不是把所有的子模板都填上去。 我在说明里这么写有什么歧义吗？请反馈，我改一下。 主模板是必须的，根据需要选择不同的子模板by color、by tag或by brackets tag。将主模板中runItemTemplate函数的第一个参数更改为不同的子模板名称实现调用不同子模板，即[item]by tag/[item]by color/[item]by brackets tag。生成笔记时选择主模板Generate note from annotations。 — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you commented.Message ID: ***@***.***>

[jokerhoneyyeah]

大佬您好！我发现html（也就是用快照方式生成的文件）可以生成主模板笔记却不能生成子模板笔记，请问应该怎么修改。（PDF文件配置是正常显示的）

[zhikaiyici]

我测试没有问题，描述一下你的操作，说明用的是哪个子模板。

[jokerhoneyyeah]

非常感谢您的回复！！！我的操作如下：

1️⃣为保留浏览器插件功能，使用zotero的save webpage with shot保存网页快照

2️⃣在保存的html文件上做批注。使用Action插件

3️⃣使用by color子模板，由于我使用默认颜色，完全不修改子模板。主模板仅更改runItemTemplate("[item]by color"

4️⃣生成笔记。html文件的笔记主模板生成成功，子模板无法提取注释。pdf文件的笔记生成成功。

再次感谢大佬的神级工具和耐心解答！！！

[zhikaiyici]

在模板中对附件类型添加了判断，只有满足附件类型为isPDFAttachment()或isSnapshotAttachment()或isEPUBAttachment()才会提取注释。目前来看，只有zotero自动创建的网页快照才能满足isSnapshotAttachment()的判定，如果用户将网页类型的附件（即.html文件）手动拖到条目下，或者将zotero自动创建的网页快照移动变为链接的附件之后，这个文件就不能满足isSnapshotAttachment()的判定条件。也就是说，在你的条目下的PMC8316981 1.html文件没有满足isSnapshotAttachment()，所以没有在其中提取注释。

解决方案：
替换附件判定条件中i.isSnapshotAttachment()为(i.isFileAttachment() && i.attachmentContentType == 'text/html')

[jokerhoneyyeah]

成功了！！！🎉🎉谢谢大佬！！！🎉🎉
我使用了方案1，发现提示：Template Preview Error: Error: getAnnotations() can only be called on file attachments
因为是代码小白，丢进AI后进行修改，成功生成笔记！！
分享完整版给可能有需要的人：

      const attachments = Zotero.Items.get(topItem.getAttachments()).filter((i) => 
          i.isFileAttachment() &&  // 新增：确保是文件附件
          (i.isPDFAttachment() || 
           i.attachmentContentType === 'text/html' || 
           i.isEPUBAttachment())
      );

再次感谢大佬的宝贵时间和耐心快速地解答！！！

[zhikaiyici]

替换i.isSnapshotAttachment()为(i.isFileAttachment() && i.attachmentContentType == 'text/html')即可。

[ZPQ12233]

大佬你好，我将主模板和子模板都导入了，在生成笔记的时候，子模版显示
template: '[item]by brackets tag'
items:
- 1/4EV8IFNI

请问这种情况该如何解决？

[zhikaiyici]

已经说明过这个问题了。

[jidizhou]

修改主模板改为调用by tag，显示不了笔记内容，by color很正常，有标签分类。by brackets bag也正常，但只摘录了所有注释的文本。关键是笔记中都有四角码的东西显示在笔记中，请问大佬，是哪里出了问题呢？

[zhikaiyici]

确保标注的标签和模板内定义的标签一致。
生成笔记时选择主模板Generate note from annotations。

[jidizhou]

是主模板，by color 都正常啊，by tag 和by brackets bag都是直接用您的代码，by tag就不能呢？在action&tag 插件中添加了您给出的tag脚本，也还是不行呢？是什么问题呢？

[zhikaiyici]

正如我之前所说，要确保标注的标签和模板中定义的标签是一致的。如果不懂这句话的意思请仔细看一下模板的使用说明。
另外，你应该注意到，action插件脚本根据颜色自动给标注添加的标签与模板中的标签是不一致的。

[jidizhou]

可以了，确实如此，问题出现在英文标签名的大小写上面。

[jidizhou]

感谢🙏！

[trashpandaxx]

大佬好，我是直接安装你的代码原封不动复制进去的，为什么主模板还是运行不了提示 Template Preview Error: ReferenceError: items is not defined，请问是哪里出了问题呢

[zhikaiyici]

使用从剪切板导入模板试试。

[trashpandaxx]

完美解决了问题，谢谢大佬！！！

[GE0rock]

Template [item]无本地连接 中文文献 Error: ReferenceError: getAnnotationsByTag is not defined 报出这个错误怎么解决呀

[zhikaiyici]

大概率是你导入模板出问题了。使用从剪切板导入模板功能重新导入。

[GE0rock]

大佬，因为我复制粘贴后试着修改了一下然后就出现了这个报错，可以看看怎么修改吗

${(() => { const date = topItem.getField("date").split('T')[0]; const title = topItem.getField("title"); const titleTranslation = topItem.getField("titleTranslation"); if (date && titleTranslation) { return `(${date}) ${title} (${titleTranslation})`; } else if (date) { return `(${date}) ${title}`; } else { return `${title}`; } })()}

作者: ${topItem.getCreators().slice(0, 10).map((v) => v.firstName + " " + v.lastName).join("; ") + (topItem.getCreators().length > 10 ? "; et al." : ";")}

期刊: ${topItem.getField('publicationTitle')}, ${(()=>{ const volume = topItem.getField('volume'); const issue = topItem.getField('issue'); const pages = topItem.getField('pages'); const year = topItem.getField('date').split('-')[0]; let line = ""; if (volume) { line += volume; if (issue) { line += '(' + issue + ')'; line += pages ? ": " + pages + "," : "," } else { line += pages ? ": " + pages + "," : "," } } else if (issue) { line += '(' + issue + ')'; line += pages ? ": " + pages : "," } else { line += pages ? pages + "," : "" } line += year ? " " + year + "." : ""; return line; })()}

期刊分区: ${{ let space = " ㅤㅤ ㅤㅤ" return Array.prototype.map.call( Zotero.ZoteroStyle.api.renderCell(topItem, "publicationTags").childNodes, e => { e.innerText = space + e.innerText + space; return e.outerHTML } ).join(space) }}$

${(() => { const abstractTranslation = topItem.getField('abstractTranslation'); if (abstractTranslation) { return `摘要翻译: ${abstractTranslation}`; } else { return `摘要: ${topItem.getField('abstractNote')}`; } })()}

标签: ${topItem.getTags().map(tagObj => tagObj.tag.startsWith('#') ? tagObj.tag + ' ,':'').join(' ') || ''}

笔记日期: ${new Date().toLocaleString()}

🤨 WHAT

---

Tips: 对文章内容、工作概括

🤷 WHY do

${await getAnnotationsByTag('WHY do')}

💁 why HERE

${await getAnnotationsByTag('why HERE')}

😤 Controversy 争议

${await getAnnotationsByTag('Controversy 争议')}

💪😎 Did what

${await getAnnotationsByTag('Did what')}

🧐 HOW

---

🤓☝️ HOW to do

${await getAnnotationsByTag('HOW to do')}

📝 Methods

${await getAnnotationsByTag('Methods')}

🥸 Results 实验结果

${await getAnnotationsByTag('Results 实验结果')}

🤯 Discovery

${await getAnnotationsByTag('Discovery')}

☠️ FINALLY

---

Tips:收获

🌾 Harvest 收获

${await getAnnotationsByTag('Harvest 收获')}

🕵️ Conclusion 结论

${await getAnnotationsByTag('Conclusion 结论')}

✍️ ELSE

---

😵 ?

${await getAnnotationsByTag('?')}

[zhikaiyici]

看起来你已经把模板改得完全不是原来的逻辑了，所以，我没办法帮你改。

以及，你应该把代码放在代码块里，你不检查一下你发出来的东西吗？

[cue2022]

请问一下：使用by color子模块，只能提取全文高亮注释，无法提取下划线注释，如何解决呢？

[zhikaiyici]

1. 更新BN插件/zotero到最新版。
2. 检查模板内定义的颜色和标注的颜色是否一致。

[cue2022]

您好，问题仍然存在

> 更新BN插件/zotero到最新版。
BN插件版本v2.5.5，zotero 7.0.22

> 检查模板内定义的颜色和标注的颜色是否一致。
已检查一致。相同颜色的高亮和下划线，仅提取高亮注释。

[zhikaiyici]

我测试高亮和下划线注释都可以被提取到笔记中。

存在的问题是：在笔记中点击显示注释颜色，下划线类型的注释会转变为高亮类型的注释。
我研究一下看看能不能解决这个问题。

[zhikaiyici]

存在的问题是：在笔记中点击显示注释颜色，下划线类型的注释会转变为高亮类型的注释。 我研究一下看看能不能解决这个问题。

问题已解决，见#1426 (comment) 。更新BN插件至最新版。

[cue2022]

非常感谢！

[xiaoyukkk]

请问更新标签笔记是通过手动点击这个“更新模板生成内容”实现吗？

[zhikaiyici]

是的

[xiaoyukkk]

谢谢作者大大