ExcaliBrain 开源项目常见问题解决方案

ExcaliBrain 开源项目常见问题解决方案

excalibrain A graph view to navigate your Obsidian vault 项目地址: https://gitcode.com/gh_mirrors/ex/excalibrain

1. 项目基础介绍和主要编程语言

ExcaliBrain 是一个开源项目，它提供了一种图形化视图来导航你的 Obsidian 文件库。这个项目受到 TheBrain 和 Breadcrumbs 的启发，通过解析文件库中的文件夹和文件，以及 Markdown 文件中的链接、dataview 字段、标签和 YAML 前言，生成一个互动的、结构化的思维导图。ExcaliBrain 能够区分五种笔记之间的关系：子笔记、父笔记、朋友关系、其他朋友（右侧的横向关系）和同辈关系。项目主要使用 JavaScript 编程语言，并基于 Node.js 环境。

2. 新手使用时需特别注意的3个问题及解决步骤

问题一：无法安装 ExcaliBrain 插件

问题描述： 用户尝试安装 ExcaliBrain 插件时遇到困难，插件无法正常工作。

解决步骤：

1. 确保你的系统中已经安装了 Node.js 和 npm。
2. 确保你的 Obsidian 文件库中已经安装并启用了 Dataview 和 Excalidraw 插件，因为 ExcaliBrain 是基于这两个插件构建的。
3. 通过命令行进入你的 Obsidian 文件库目录，运行 npm install 来安装所有必要的依赖。
4. 如果安装过程中出现错误，检查 package.json 文件中是否有误，并根据错误信息进行调整。

问题二：思维导图无法正常显示

问题描述： 用户安装完插件后，发现思维导图无法正常显示。

解决步骤：

1. 确认你的 Obsidian 文件库中的 Markdown 文件是否包含有效的链接、dataview 字段、标签和 YAML 前言。
2. 检查是否有任何语法错误或格式问题导致 ExcaliBrain 无法正确解析文件。
3. 重新启动 Obsidian 应用程序，确保所有插件都被正确加载。

问题三：无法在思维导图中找到特定笔记

问题描述： 用户在思维导图中无法找到自己期望的特定笔记。

解决步骤：

1. 确认该笔记是否已经包含在文件库中，并且已经正确链接到其他笔记。
2. 检查笔记的 YAML 前言是否包含正确的元数据，以帮助 ExcaliBrain 识别和显示。
3. 在 ExcaliBrain 设置中检查是否所有类型的笔记关系（如子笔记、父笔记等）都已启用显示。
4. 如果问题仍然存在，尝试清除缓存并重新加载思维导图。

通过遵循上述步骤，新手用户应该能够顺利解决在使用 ExcaliBrain 项目时遇到的一些常见问题。

excalibrain A graph view to navigate your Obsidian vault 项目地址: https://gitcode.com/gh_mirrors/ex/excalibrain