[!example] 插件名片
基本用法
- 在默认情况下,本插件会自动检索全库笔记,如果当前笔记中有词句与同库其他笔记的标题或别名相同,则会自动将其渲染为
虚拟链接
,无需人工添加。虚拟链接
在编辑模式和阅读模式下均可生效, 如果库或文本内容发生变化,虚拟链接
会保持实时更新。 虚拟链接
类似于OB原生的内部链接
(internal link),可点击跳转,也可将鼠标移至上方调出悬浮窗口查看,但并不会像内部链接
那样使用双链语法污染文本,也不会在关系图谱或状态栏中的反链出数统计中显示,但如果想将之转为内部链接
也很简单,只消右键点击虚拟链接
在菜单中选择Convert to real link
命令即可将其转为内部链接
,比系统自带出链
核心插件的当前笔记中潜在的链接
功能更为直观和方便
设置说明(启用Show advanced setting
)
Matching behavior
Include aliases
:如启用,匹配范围内笔记的文件属性中的alias(即别名)
项也将被纳入匹配范围Only link once
:如启用,当前笔记中的匹配词只会在第一次出现时显示为虚拟链接
,类似于WIKI百科的样式,有助于保持页面简洁Exclude links to real linked files
:如启用, 插件不会为实际存在的内部链接(internal link)
添加虚拟链接
Include headers
:如启用,小标题也会被纳入匹配范围Match any part of a word
:如启用,匹配词的任一部分都会参与部分匹配,如禁用,则插件只会进行完全匹配Match the beginning of words
:如启用,匹配词的开头部分也会被渲染成虚拟链接
,优先级高于Match any part of a word
选项,比方说,“note”和“notebook”会匹配Match the end of words
:如启用,匹配词的结尾部分也会被渲染成虚拟链接
,优先级高于Match any part of a word
选项,比方说,“book”和“notebook”会匹配Suppress suffix for sub words
:如启用,后缀不会被纳入链接范围,仅在完整匹配模式下生效Fix IME problems
:如启用,则在当前行开始处不会实时生成虚拟链接
,这是因为在使用输入法输入QWERTY键盘无法输入的语言(比如汉语日语韩语等)时,可能会跟插件发生冲突,如果使用IME输入中文等语言,建议启用此选项Avoid linking in current line
:如启用,则在正在编辑的当前行内不会实时生成虚拟链接
,可避免分散注意力,等到移到其他行后才会生成虚拟链接
Case sensitivity
Case sensitive
:如启用,则匹配过程将会区分大小写,用户可为笔记添加标签(标签文本可在Tag to match case
或Property to ignore case
选项中自定义)以调整其大小写敏感度Capital letter percentage for automatic match case
:大小写敏感的程度百分比Tag to match case
:在空白栏中填入特定文本,将其指定为标签
,插件对拥有此标签的笔记会区分大小写Property to ignore case
:在空白栏中填入特定文本,将其指定为属性名称
,插件对拥有此属性名称的笔记,会忽略其被赋于的属性值
的大小写property to match case
:在空白栏中填入特定文本,将其指定为属性名称
,插件对拥有此属性名称的笔记,会区分其被赋于的属性值
的大小写
Matched files
Include all files
:- 如启用,则全库的笔记都将被插件识别,可在
Excluded directories
选项中后的空白栏中填入特定文件夹路径,将特定文件夹排除出匹配范围, - 如禁用,则可在
Glossary Linker directories
选项后的空白栏中填入特定文件夹路径,插件会只监测这些文件夹内的笔记名称或别名。
- 如启用,则全库的笔记都将被插件识别,可在
tag to include file
:在空白栏中填入特定文本,将其指定为标签
,插件会监测拥有此标签的笔记的名称或别名tag to ignore file
:在空白栏中填入特定文本,将其指定为标签
,插件会排除拥有此标签的笔记的名称或别名Exclude self-links to the current file
:如启用,则插件不会在本笔记中监测本笔记的名称或别名,如禁用,则插件会在本笔记中监测本笔记的名称或别名,但可能出现bugExclude directories for generating virual links
:在空白栏中填入特定文件夹路径,插件不会在这些文件夹的笔记中生成虚拟链接
Link style
Always show multiple references
:如启用,则同时有多个匹配结果的虚拟链接
将显示多个结果Virtual link suffix
:在空白栏中填入文本,将其指定为虚拟链接
的后缀,可以是图标也可以是文本,后者默认以上标形式表示Apply default link styling
:如禁用,则可在.obsidian/snippets/
中添加自定义css样式:
/* 鼠标未在虚拟链接上悬停时的属性 */
.virtual-link.glossary-entry a {
/* 鼠标未在虚拟链接上悬停时颜色如常 */
color: inherit;
/* 将其颜色设定为红色 */
/* color: red; */
/* 虚拟链接的下划虚线的粗细、颜色和其他属性也可自定义 */
text-decoration-thickness: 1px;
text-decoration-color: rgb(var(--color-purple-rgb), 0.6);
text-underline-position: under;
/* text-decoration-style: dotted; */
/* text-underline-offset: 0em; */
}
/* 鼠标未在虚拟链接上悬停时的属性 */
.virtual-link.glossary-entry a:hover {
color: var(--link-color);
}
Use default link style for conversion
:如启用,则自定义链接样式将在虚拟链接
向内部链接
的转变中生效