Releases: XiaoDuComrade/zotero-margin-comments
Release list
V0.9.1 卡片长度调整
每侧独立计算剩余空间。
卡片按 3→4→5→6 行逐轮公平扩展。
最多显示 6 行,空间不足继续使用“还有 N 条”。
悬停显示完整浮层,不改变其他卡片位置。
点击进入完整编辑,内容过多时边栏滚动。
取消低缩放比例下自动切换单行,减少缩放跳位。
V0.9.0 更新支持zotero10
Merge pull request #3 from XiaoDuComrade/agent/margin-comments-0.8.1 Release Margin Comments 0.8.6
V0.8.5 修改设置文字说明
Merge pull request #2 from XiaoDuComrade/agent/margin-comments-0.8.1 Update margin comments plugin to v0.8.1
V0.8.4 新增缩小批注便签图标大小,在设置里打开
这个功能有较强的版本依赖。目前插件明确适配并测试的是 Zotero 9.0.6,安装范围限制在 Zotero 9.0.x。小版本升级后通常还能用,但如果 Zotero 修改 Reader 内部结构,就可能需要重新适配。
实现方法大致分三层:
图标绘制
Zotero 9.0.6 的便签不是普通 SVG/HTML,而是由 PDF Reader 的 Canvas 渲染器绘制。插件在 Reader 自身的运行环境中补丁 _drawNote(),把 24×24 的图标居中缩放成 14×14。
点击和拖动区域
视觉缩小并不会自动改变点击范围,因此插件同时接管:
getSelectableAnnotations():控制未选中便签的点击范围。
getSelectedAnnotationAction():控制已选中便签的拖动范围。
两者都使用与 14px 图标完全相同的矩形,因此不会出现“图标很小,但旁边空白也能点中”的情况。
旁注引线
Zotero 保存的便签坐标仍然是原始矩形。插件不会修改数据库,而是在计算引线时临时换算出缩小后图标的位置,让引线连接到图标上边缘。缩放、旋转或重新渲染后会重新计算。
版本限制主要来自 _drawNote() 和两个命中测试方法都属于 Zotero Reader 的内部实现,并非稳定的插件 API。如果以后 Zotero 改成 SVG、DOM 渲染,或者重命名这些内部方法,功能可能暂时失效,但不会破坏批注数据;关闭选项后也会恢复 Zotero 原始方法。
V0.8.1 新增批注类型筛选
V0.7.10 修复框选和复制粘贴快捷键问题
更新内容
旁注编辑器改用 Zotero Reader 兼容的富文本编辑方式。
支持鼠标拖动框选旁注文字。
修复选区已生成但高亮不可见的问题。
修复 Ctrl+C 无法复制旁注文字的问题。
复制操作改用 Zotero 原生特权剪贴板接口。
支持 Ctrl+A 全选当前旁注。
支持 Ctrl+B 加粗和 Ctrl+I 斜体。
支持粗体、斜体、下标和上标格式。
富文本解析异常时自动退回纯文本,避免整页旁注消失。
增加 Zotero bootstrap 沙箱兼容性保护。
校验
SHA256: F6646D822461E91165DEA126750876EFB42A61982AC377D340D74BB49964D3AA
V0.7.4 Margin Comments
Zotero Margin Comments 0.7.4
首个公开发布版本,为 Zotero 9 PDF 阅读器提供可编辑的页边批注。
主要功能
- 将高亮解释和独立文本批注显示在 PDF 页面左右页边。
- 根据批注所在位置自动选择左侧或右侧,并通过引线连接原批注。
- 直接点击页边评论编辑,修改内容自动保存。
- 长评论折叠为三行;内容溢出页面时可展开并在边栏中滚动。
- 鼠标悬停时联动突出评论卡片、引线和 PDF 批注。
- 适配 Zotero 原生批注筛选,隐藏或恢复对应的页边评论。
- 优化缩放居中、页面滚动和大量批注恢复时的性能。
兼容性
- Zotero 9.0.x
- PDF 附件
安装
下载下方的 margin-comments-0.7.4.xpi,在 Zotero 中打开“工具 → 插件”,通过齿轮菜单选择“从文件安装插件”。
校验
SHA256: 6A20B5F2030622C466A64C375302E75F5BCBEA453AB0B9A7354C7E83A5E36905
