Obsidian 插件：Waypoint 快速创建笔记 MOC 结构

概述

Waypoint 是一个 Obsidian 插件，可以自动生成文件夹注释中的目录/MOC。一旦生成了一个导航锚点，它将自动链接到文件夹及其子文件夹中的每个笔记。Waypoint 插件将检测您何时创建/重命名/移动/删除注释，并自动保持最新状态。

效果&特性

使用

若你使用文件夹对笔记进行分类，并希望 Obsidian 在图形视图中不用每次创建文件时都要跟踪标签和链接的变动情况，或者厌烦决定哪些文件夹应该作为分类，而不必为每个文件夹创建索引文件？

Waypoint 是 Obsidian 的一个插件，可以自动在您的文件夹笔记中生成目录/ MOC（Map of Content）。一旦生成了一个导航锚点，它将自动链接到文件夹及其子文件夹中的每个笔记。Waypoint 插件将检测您创建/重命名/移动/删除笔记的操作，并自动保持最新状态。不再需要处理大量的标签或手动更新自己的内容地图！

特点

• 自动生成目录！
  • 每当您在文件夹笔记中输入魔术词（默认为 %% Waypoint %%）时，就会创建航点。文件夹笔记是与其父文件夹同名的任何笔记。
• 文件/文件夹创建、重命名、移动或删除时立即更新
  • 文件路径更改会触发扫描可能受到影响的任何航点。如果找到航点，则会实时立即更新。
• 文件夹现在可以在图形视图中显示
  • 只需在与文件夹同名的笔记中创建一个航点，它将自动链接到其中的每个文件，包括子文件夹中的文件！
  • 航点可以“嵌套”以避免不必要的链接
    • 假设您的文件夹从 A -> B -> C。如果您在文件夹 A 的文件夹笔记中放置一个航点，它将包括文件夹 A、B 和 C 中的每个文件。但是，如果您在文件夹 B 中创建另一个航点，第一个航点将只链接到该文件夹笔记。
• 对哪些文件夹被视为类别有精细控制
  • 由于您可以在文件夹树中决定何时何地生成航点，因此可以决定哪些文件夹可以被视为“类别”，哪些只是用于组织。
  • 假设您的文件夹树如下：Latin -> Chapter I -> Vocab -> ...。“Latin” 和 “Chapter I” 可能被认为足够重要以被称为类别，但是每个章节中的 “Vocab” 文件夹只是用于保持组织。其他插件可能要求在每个文件夹中创建索引文件，但是 Waypoint 允许您选择包含目录的文件夹笔记。这意味着您可以避免在每个 “Vocab” 文件夹中创建航点，同时仍然在每个章节文件夹中创建航点，直接链接到每个术语。由于 Waypoint 如何优先考虑文件夹层次结构，“Latin” 文件夹笔记中的航点将仅链接到章节文件夹笔记，以避免创建不必要的链接！
• 永久和可移植
  • 与其他插件不同，航点是作为真实的 Markdown 文本生成并保存在您的文件夹笔记中的。如果您决定切换到支持 链接 的其他 Markdown 编辑器，所有目录仍然可用。
  • 请注意，Waypoint 插件目前仅适用于 Obsidian，因此在其他编辑器中移动文件将导致航点过时。

如何使用

• 首先，安装插件。Waypoint 目前正在审核中，以便被包含在社区插件列表中。一旦被接受，您将能够直接在 Obsidian 中安装它。
• 通过编辑文件夹笔记（与其父文件夹同名的笔记）并输入航点触发文本来生成航点。默认情况下，这是 %% Waypoint %%。请确保两边都包含双百分号！
  • 这个触发标志可以在设置中更改，但它始终需要双百分号，因为这是 Obsidian 知道它是注释而不是真正的文本的方式。
• 就是这样！只要更改了该文件夹中的文件或文件夹，航点就会自动更新。请确保不要删除 %% Begin Waypoint %% 或 %% End Waypoint %% 标志，因为这是插件用来定位目录的地方。一旦更新了航点，这些标志之间的文本更改将被删除。

请注意，由于航点只能在文件夹笔记中生成，强烈建议您安装像 Folder Note 这样的插件，以确保在文件夹重命名和其他更改文件树的操作后不会丢失文件夹笔记。如果包含航点的文件夹笔记被重命名为与文件夹名称不同的名称，航点将不再更新。

当前限制

• 只能在文件夹笔记中创建航点
  • 因为每次文件/文件夹更改时扫描航点是一个密集的过程，所以只检查文件夹笔记，以避免扫描存储库中的每个文件。
• 不能在存储库的顶层创建航点
  • 航点用于对相似的笔记进行分类。在根节点添加航点将导致链接存储库中的每个笔记，从而失去使用航点的初衷。
• 航点外观不能自定义（尚未支持）
• 每个文件夹笔记只能创建一个航点

如果您的工作流程可以通过解除这些限制来改进，请随时与我联系，并告诉我您的用例，我会尽力解决！

常见问题解答

为什么我要使用这个插件而不仅仅使用标签呢？

标签是一种按照类型或类别对不同笔记进行排序和组织的简单方法，但它们有一些缺点限制了它们的可用性。我个人不广泛使用标签的原因是它们需要手动添加或删除，并且不能以有意义的方式嵌套。另一方面，文件夹是将一堆笔记归类到特定类别的明确且简单的方式。而且，嵌套文件夹的能力使得记录个别类别之间的关系变得更加容易。使用这个插件，您可以轻松地将同一文件夹中的文件链接在一起，而无需进行任何手动簿记（除了创建初始航点）。尽管如此，我仍然发现自己使用标签来定义不同类型的笔记，因为即使我移动它们，它们也不太可能改变。

Zoottelkeeper 和其他相关插件更加复杂，试图解决不同的问题。Zoottelkeeper 会自动为存储库中的每个文件夹创建索引文件（可定制的黑名单和白名单）。这意味着每个文件夹都会显示在图形视图中，并且只链接到当前文件夹下方的索引文件。如果您很少使用文件夹，并且每个文件夹都有重要且特定的含义，那么这非常好，但如果您将文件夹作为主要的组织方法，那么您的图形将很快变得混乱。

Waypoint 的创建是为了让用户对哪些文件夹足够重要以被视为“笔记类别”具有精细控制。它允许您创建目录，不仅链接到同一文件夹中的文件，还链接到子文件夹中的文件。如果您决定某些子文件夹值得成为自己的子类别，创建一个航点将自动修剪父航点，并更新为仅链接到该文件夹的文件夹笔记。如果您希望您的航点仅链接到最近的文件夹笔记（无论它们是否包含航点），您可以在设置中启用该功能。

联系方式

有任何问题、评论或关注事项吗？请随时通过 GitHub 提出问题或与我联系 @IdreesInc。如果您想查看我的其他项目，请访问我的网站 idreesinc.com。

讨论

若阁下有独到的见解或新颖的想法，诚邀您在文章下方留言，与大家共同探讨。