[Item] Annotation Matrix

[windingwind]

Description

Collect annotations with tags that start with * into a table.

rows: attachment files;
columns: tags
cells: annotations

Screenshots

Test on Zotero version

7.0.0-beta.97+b899fc9d4

Test on Better Notes version

1.1.4-beta99

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] Annotation Matrix"
content: |-
  // @use-refresh
  // @beforeloop-begin
  <h2>Annotation Matrix</h2>
  <table>
  <tr>
  <th>Papers</th>
  ${{
    function getColumns(attachmentItems) {
      cols = [];
      attachmentItems
        .filter((item) => item.isAttachment())
        .reduce((annots, item) => [...annots, ...item.getAnnotations()], [])
        .forEach((annot) => {
          const tags = annot
            .getTags()
            .map((tag) => tag.tag)
            .filter((tag) => tag.startsWith("*"));
          cols.push(...tags);
        });
      return Array.from(new Set(cols));
    }
    async function getPDFLink(item) {
      const att = await item.getBestAttachment();
      if (!att || !att.isPDFAttachment()) {
        return "";
      }
      key = att.key;
      if (att.libraryID === 1) {
        return `zotero://open/library/items/${key}`;
      } else {
        groupID = Zotero.Libraries.get(att.libraryID).id;
        return `zotero://open/groups/${groupID}/items/${key}`;
      }
    }
    sharedObj.getPDFLink = getPDFLink;
  
    attachments = items.reduce(
      (atts, item) => [...atts, ...Zotero.Items.get(item.getAttachments())],
      []
    );
    cols = getColumns(attachments);
    sharedObj.cols = cols;
    let str = "";
    for (const col of cols) {
      str += `<th>${col}</th>`;
    }
    return str;
  }}$
  </tr>
  // @beforeloop-end
  // @default-begin
  <tr>
  <td>
  ${{
    const creators = topItem.getCreators();
    let content = "";
    const year = topItem.getField("year");
    if (creators.length === 0) {
      content = "no author";
    } else if (creators.length === 1) {
      content = `${creators[0].lastName}, ${year}`;
    } else {
      content = `${creators[0].lastName} etal., ${year}`;
    }
    const link = await sharedObj.getPDFLink(topItem);
    let str = `<a href="${link}">${content}</a >`;
    return str;
  }}$
  </td>
  ${{
    const annotations = Zotero.Items.get(topItem.getAttachments())
      .filter((item) => item.isPDFAttachment())
      .reduce((annots, item) => [...annots, ...item.getAnnotations()], []);
    let str = "";
    for (const col of sharedObj.cols) {
      const colAnnots = annotations.filter((annot) =>
        annot
          .getTags()
          .map((tag) => tag.tag)
          .includes(col)
      );
      str += "<td>";
      str += await Zotero.BetterNotes.api.convert.annotations2html(colAnnots, {
        noteItem: targetNoteItem,
      });
    }
    str += "</td>";
    return str;
  }}$
  </tr>
  // @default-end
  // @afterloop-begin
  </table>
  // @afterloop-end

Anything else

No response

[pengxy0]

👍👍👍

[fredericky123]

这个功能有没有可能与tag action联动一下，为每个collection自动生成这个matrix，并且根据collection下的item的增加而自动更新

[yangyixinxin]

no response

[stijndecoster]

The explanation here says: Collect annotations with tags that start with *

But can it also collect stand-alone notes with tags that start with *?

[windingwind]

You can edit the template to replace the annotations2html and corresponding code to note2link, then replace the input annotations to notes.

[Tato25bug]

Can I use this to locate every pdfs that have a tag with *? I noticed that I need to make sure that this file has * on tags otherwise it wont work. I want to use it for comparison