ZotLit

摘录图片

ZotLit 如何生成图片与手绘摘录、检查缓存图片以及保留保存在笔记中的图片。

摘录图片显示所选的 PDF 区域或覆盖在 PDF 内容之上的手绘笔画。

当你查看或导入标注时,ZotLit 会生成这些图片。此时两个 PDF 阅读器都可以保持关闭,在 Obsidian 最小化时生成也会继续进行。当 Zotero 保存的标注数据和 PDF 本地可用时,Zotero 也可以保持关闭。

标注视图中的图片

ZotLit 会首先在其自身缓存中查找匹配的图片。若未找到,则会从 PDF 生成摘录。若生成失败,它会尝试使用 Zotero 缓存的 PNG 图片。

标注视图会显示任何可用的图片,且不带有缓存来源标签。查看卡片不会在仓库中创建保存的图片文件。若所有来源均失败,卡片将显示图片不可用。

保存的笔记快照

保存在笔记中的图片属于快照。每个新的图片版本都有独立的文件名。更新某篇笔记可能会选用新版本,而其他笔记仍保留现有的图片。

ZotLit 会在创建笔记、更新、覆盖、重新导入或插入标注时准备这些文件。在修改引用旧图片文件的笔记之前,ZotLit 会一直保留旧图片文件和既有链接。它不会自动删除未使用的图片版本。

嵌入在 Zotero 子笔记中的普通图片仍为存储的快照。只有在标注模板模式下符合条件的标注段落才会使用实时摘录。重新导入此类段落可能会更改其图片;其他嵌入图片则保留随子笔记存储的字节数据。

缓存与时效性

摘录缓存归属于单个设备上的特定仓库,并在 Obsidian 重启后依然保留。其大小上限为 256 MiB。当需要空间时,ZotLit 会移除最近最少使用的条目。清除或移除缓存条目不会影响笔记中已保存的图片。

在复用缓存图片之前,ZotLit 会检查标注的渲染输入以及 PDF 的文件大小和修改时间。裁剪几何形状或手绘颜色的变动需要重新匹配。若替换了 PDF 但文件大小与修改时间均保持不变,则可能会复用旧图片。

当 PDF 不可用时,如果标注输入匹配,缓存图片仍可被使用。ZotLit 会报告未检查 PDF 的时效性。一旦 PDF 恢复可用,它会在下一次相关的查看或导入操作中重新检查。

导入结果

笔记操作会在运行最终模板之前准备图片。每个模板仅执行一次。该操作仅统计模板所请求的图片辅助函数。

若刷新失败,ZotLit 会保留该笔记已引用的已验证图片,并报告为未刷新。否则,它会写入图片不可用的说明和来源链接。其他标注和笔记仍可继续完成。

每次操作或批处理会生成一份摘要,统计来自 Zotero 且时效性不确定的图片、未检查 PDF 时效性的图片、不可用的图片以及保留未刷新的图片。成功生成和有效的缓存复用无需在摘要中列出。

若禁用了附件导入,ZotLit 不会为笔记创建生成的图片文件。已验证的现有图片可以保留;否则笔记将收到图片不可用的说明和来源链接。标注视图中的图片和设备缓存仍保持可用。

有关笔记操作,请参阅使用标注视图、保持笔记为最新和导入 Zotero 笔记。缓存设置介绍了手动清除缓存的方法。

最后更新于

本页目录