发帖前搜索:新建错误报告前,请搜索中英论坛重复话题。
故障排查指导
为修复可能的故障,需要可靠和一致的复现步骤。
你可以先进行以下步骤,看是否解决了故障:
- 将原库每个插件和主题更新至最新版。
- 检查 Ob 设置和插件设置里每个选项。Style Settings 插件是最常见需检查的插件。
- 阅读 Markdown 语法、Obsidian Help、插件说明,检查是否正确应用 YAML 等。
鉴于 Obsidian 中文帮助内容不全,文末简单介绍 YAML,更多还请自行阅读 Obsidian Help。
若未解决,首先,排查是否是 Obsidian 本体的问题。
打开沙箱仓库,操作如下图:
不下载任何插件、主题,不启用任何额外 CSS 片段,看在相同操作下能否复现故障。
若沙箱复现:
- 输入类故障,考虑排查输入法。例如,搜狗输入法默认将数字后的中文句号改为点号。相似问题:微软输入法重复跳字
- 手动下载 Ob 最新安装包重装,再次沙箱排查,看是否稳定复现。
若确认稳定复现,可将错误报告在 英文论坛“Bug reports”类别(推荐!)或中文论坛“建议反馈”类别。
信息越有质量越完整,越可能得到有用的答案,见 论坛发帖指导2023“求助反馈不重不漏自查表”。若英文论坛报告,可用 Ob 自带命令“显示调试信息”,获取“SYSTEM INFO”。
若沙箱不能复现,说明原库有插件、主题、CSS 等冲突。此时话题通常不应发到“建议反馈”类别。
接着,在沙箱依次下载启用你原库加载的插件、主题及额外 CSS 片段,检查里面每个选项,每次新启用后尽量都重启一遍 Ob,看在相同操作下能否复现。
当你找到问题源头,你可以:
- 在插件/主题的 GitHub 页面报告(推荐!)。
- 新建类别“疑问解答”,可选标签“插件”/“css”。
附:能用就行的 YAML 简介
YAML 区的内容,代表文档的信息,“元数据”,英文为 Metadata、Properties 等。
混淆 YAML 含义所致错误,可参 Dataview 插件,flatten 分行问题
源码模式的 YAML,对应 Ob 设置 - 编辑器 - 文档属性 - 显示,图形化的 YAML:
↔
作为一种成熟的标记语言,Ob 的 YAML 和一般的 YAML 没什么区别,都是注意全英文符号、字符串两边双引号等。有了文档属性视图将 YAML 区图形化,基本是傻瓜式操作。
在插件、主题、CSS 说明中找到具体需要的文档属性和值,首行空行输入三个 -
,或标签右键 - 增加文档属性,或快捷键,可添加 YAML。
一个添加 YAML 的实例:Markmind 无法调用、工具栏没有按钮。