故障排查指导 Troubleshooting Guide

发帖前搜索:新建错误报告前,请搜索中英论坛重复话题。

故障排查指导

为修复可能的故障,需要可靠和一致的复现步骤。

你可以先进行以下步骤,看是否解决了故障:

  • 将原库每个插件和主题更新至最新版。
  • 检查 Ob 设置和插件设置里每个选项。Style Settings 插件是最常见需检查的插件。
  • 阅读 Markdown 语法、Obsidian Help、插件说明,检查是否正确应用 YAML 等。

鉴于 Obsidian 中文帮助内容不全,文末简单介绍 YAML,更多还请自行阅读 Obsidian Help

若未解决,首先,排查是否是 Obsidian 本体的问题。

打开沙箱仓库,操作如下图:

image

不下载任何插件、主题,不启用任何额外 CSS 片段,看在相同操作下能否复现故障。

若沙箱复现:

  • 输入类故障,考虑排查输入法。例如,搜狗输入法默认将数字后的中文句号改为点号。相似问题:微软输入法重复跳字
  • 手动下载 Ob 最新安装包重装,再次沙箱排查,看是否稳定复现。

若确认稳定复现,可将错误报告在 英文论坛“Bug reports”类别(推荐!)或中文论坛“建议反馈”类别。

信息越有质量越完整,越可能得到有用的答案,见 论坛发帖指导2023“求助反馈不重不漏自查表”。若英文论坛报告,可用 Ob 自带命令“显示调试信息”,获取“SYSTEM INFO”。

image

若沙箱不能复现,说明原库有插件、主题、CSS 等冲突。此时话题通常不应发到“建议反馈”类别。

接着,在沙箱依次下载启用你原库加载的插件、主题及额外 CSS 片段,检查里面每个选项,每次新启用后尽量都重启一遍 Ob,看在相同操作下能否复现。

当你找到问题源头,你可以:

  • 在插件/主题的 GitHub 页面报告(推荐!)。
  • 新建类别“疑问解答”,可选标签“插件”/“css”。

附:能用就行的 YAML 简介

YAML 区的内容,代表文档的信息,“元数据”,英文为 Metadata、Properties 等。
混淆 YAML 含义所致错误,可参 Dataview 插件,flatten 分行问题

源码模式的 YAML,对应 Ob 设置 - 编辑器 - 文档属性 - 显示,图形化的 YAML:

imageimage

作为一种成熟的标记语言,Ob 的 YAML 和一般的 YAML 没什么区别,都是注意全英文符号、字符串两边双引号等。有了文档属性视图将 YAML 区图形化,基本是傻瓜式操作。

在插件、主题、CSS 说明中找到具体需要的文档属性和值,首行空行输入三个 -,或标签右键 - 增加文档属性,或快捷键,可添加 YAML。

image image

一个添加 YAML 的实例:Markmind 无法调用、工具栏没有按钮

2 个赞