Obsidian 插件:Alias from heading
插件名片
概述
隐式添加一个与文档中第一个标题匹配的别名。
原文出处
下面自述文件的来源于 Readme
Readme(翻译)
下面是 obsidian-alias-from-heading 插件的自述翻译
标题别名
在 Obsidian 中,别名可以方便地为文档链接提供显示名称。然而,存在一些问题:
- 别名是在YAML中管理的,可能使用起来不太方便。
- 链接的显示名称不会随着别名的更改而同步更新。
该插件通过以下方式解决了这些问题:
- 隐式地为文档添加一个别名,该别名与该文档中的第一个标题匹配,无论标题级别如何。
- 当 输入
[[
添加链接 时,该别名将作为建议显示。 - 如果在同一文档中存在重复的别名(来自 YAML 或标题),在输入
[[
或使用快速切换器时,不会出现重复的链接建议。 - 更新文档中的第一个标题只会更新与该标题匹配的链接的显示名称。这样可以根据特定的上下文自定义链接的显示名称,但默认情况下,链接的显示名称将与标题保持同步。
- 在 YAML 中定义的任何别名仍然按照它们的标准方式工作,并且不会影响该插件的行为。与标题别名不同,更新 YAML 中的别名不会更新其关联链接的显示名称。
<!-- 2022-06-08-1030.md -->
---
aliases: "🍅 建造一个花园"
---
🍅 建造一个花园
- 检查院子
- 选择一个设计
- 购买材料
- 建造框架
- 准备地面
- 填充花床
使用这个插件,别名的前置内容不再需要。
```md
<!-- 2022-06-08-1030.md -->
# 🍅 建造一个花园
- 观察院子
- 选择一个设计
- 购买材料
- 建造框架
- 准备地面
- 填充花床
这个第二个文档只通过文件名链接到第一个文档。
<!-- 2022-02-02-1445.md -->
# 🥬 园艺项目
- [[2022-06-08-1030]]
- 发芽种子
- ...
然而,通常更易读的做法是使用友好的显示名称链接到文档。键入 [[
,按照标题搜索文档,并选择插入。
<!-- 2022-02-02-1445.md -->
🥬 园艺项目
- 🍅 建造一个花园
- 发芽种子
- …
现在,显示名称与它链接到的第一个文档的第一个标题匹配,它们保持同步。将第一个文档中的标题从 🍅 建造一个花园
更新为 🥕 建造一个提升的花园床
。现在第二个文档显示了变化。
<!-- 2022-02-02-1445.md -->
# 🥬 园艺项目
- [[2022-06-08-1030|🥕 建造一个提升式花园床]]
- 发芽种子
- ...
如果从第一个文档中删除了所有标题,那么任何保持同步的链接都会被更新,以使其显示名称与文件名匹配。这种行为使得稍后插入新标题时保持链接显示名称同步变得容易。同时,它也使得链接的预览仍然有意义。
<!-- 2022-02-02-1445.md -->
🥬 园艺项目
- 2022-06-08-1030
- 发芽种子
- …
如果想要自定义显示名称或者不显示名称,只需手动内联更改。除非手动改回与标题匹配,否则它不会与标题保持同步。
```md
<!-- 2022-02-02-1445.md -->
# 🥬 园艺项目
- [[2022-06-08-1030|🌽 花坛]]
- 发芽种子
- ...
开发者指南
阅读[Obsidian示例插件](https://github.com/obsidianmd/obsidian-sample-plugin)的自述文件和[Obsidian插件开发者文档](https://marcus.se.net/obsidian-plugin-docs/),了解如何开发、安装、测试和发布此插件。
反馈交流
其他渠道
版权声明
版权声明:所有 PKMer 文章如果需要转载,请附上原文出处链接。