解决常见问题
遇到 ZotLit 未按预期运行?对照屏幕上出现的内容,直接查看对应解决方法。
对照屏幕上出现的现象或提示,点击链接直接前往解决方案。
安装与连接
- ZotLit 提示更新 Obsidian,但 Obsidian 显示已是最新版本 —— "Update Obsidian to use ZotLit"
- 安装后 ZotLit 完全无法加载 —— "Failed to load plugin "zotlit""
- ZotLit 找不到 Zotero 文库;文库视图为空 —— "Zotero not found"
- 提示显示此设备上未找到 Zotero —— "Zotero wasn't found on this device."
- 实时更新不起作用;标注视图没有跟随 Zotero 阅读器
- 批量更新多篇文献时,Zotero 提示启用服务器或减少选择的条目
- Zotero 每次打开 Obsidian 时都弹出确认提示
- 提交错误报告时需要发送日志
Zotero 更改与同步
- Zotero 中的更改未显示在 Obsidian 中
- 在 Windows(或使用 ext4 的 Linux)上,笔记和文库视图显示的是旧的 Zotero 数据
- 安装 Companion 并更新笔记后,Zotero 中的更改仍未出现
- 在第二台设备上,仓库同步后 ZotLit 找不到 Zotero —— "Zotero wasn't found on this device."
- JavaScript(Eta)模板在一台电脑上可用,但在另一台电脑上无法使用
- 升级后,群组文库中的文献未显示在搜索中
文献、PDF 与标注
- 点击链接打开的是 Zotero 而不是 PDF
- PDF 无法打开,或 ZotLit 提示文件缺失 —— "This item has no PDF attachment."; "The PDF file is missing."
- 无法在 Obsidian 中修改标注 —— "Zotero version is not supported"; "Enable communication with Zotero"; "Waiting for approval in Zotero"
- 在 Zotero 中编辑同一标注后,之前编写的评论消失了
- 标注显示锁形图标且无法修改 —— "Locked. Zotero imported this annotation from the PDF file, so it cannot be changed."
文献笔记
- 更新了笔记,但笔记正文未发生改变 —— "Properties updated. This note has no managed region, so its body stayed unchanged."
- 来自 ZotLit v1 的笔记未更新 —— "Properties updated. This note has no managed region, so its body stayed unchanged."
- 更新全部笔记没有任何效果,并提示没有可用的文库 —— "No library in the library scope is available."
- 创建笔记时弹出选择器询问使用哪个配置方案
- 刷新时在导入的 Zotero 笔记中所做的编辑被覆盖替换
引用与导出
- 引用在参考文献侧边栏中显示为错误 —— "
@keymatches no item in your Zotero library."; "@keymatches multiple items in your Zotero library."; "This link has an invalid citation fragment."; "…points to an item that is no longer in your Zotero library." - ZotLit 无法插入引用 —— "Citation key
@…matches multiple Zotero items. Change it in Zotero before inserting a citation." - 选择要引用的文献后没有插入任何内容 —— "Selected item has no citation key: …"
- “复制参考文献”为灰色不可点击状态 —— "Fix the reference errors to copy the bibliography", "Bibliography formatting is unavailable"
- 参考文献侧边栏提示样式不可用或无法排版参考文献 —— "This note's citation and references style is unavailable", "This note's document language is invalid", "ZotLit could not format these references", "The Pandoc engine is unavailable"
- 参考文献侧边栏与笔记中引用的内容不一致
- 导出失败,或提示启动 Zotero、安装 Pandoc 引擎
- 原生 Pandoc 导出中断并带有错误代码
- 引用关系图谱命令未打开任何内容 —— "The Graph view core plugin is disabled. Turn it on in Settings → Core plugins."; "“Show citations in graph view” is turned off. Turn it on in Settings → ZotLit → Citations."
模板与查询
- 模板预览失败并报错 —— "Show problem", "Problems", "Copy error report"
- “问题”区域列出了配置方案文档中的错误 —— "This file is not a profile document."; "The manifest is not valid."
- 转换 2.1 模板被拒绝 —— "ZotLit kept the legacy templates unchanged …"
- 在转换模板之前,ZotLit 无法使用添加的配置方案 —— "Convert the legacy literature note templates before you use an added profile."
- 创建或更新笔记失败,并列出一组不生效的属性(frontmatter)键名
- 查询公式显示警告图标,或视图未显示任何行
最后更新于