Files
server-configs/siyuan/data/plugins/syplugin-hierarchyNavigate/README_zh_CN.md
2026-02-13 22:24:27 +08:00

4.8 KiB
Raw Blame History

hierarchyNavigate 文档层级导航

English

在文档标题下添加上下层文档导航的思源笔记插件。

当前版本v1.8.0

新增:上层文档内容区;改进:移动端显示;改进:相对字号;

详见 更新日志

快速开始

  • 从集市下载 或 1、解压Release中的package.zip2、将文件夹移动到工作空间/data/plugins/3、并将文件夹重命名为syplugin-hierarchyNavigate;
  • 开启插件即可;
  • 其他请浏览插件设置页面(设置集市已下载插件文档层级导航→“设置图标”),提示:设置页可以上下滑动哦
  • 带有og-hn-ignoreog文档导航忽略属性或属性值的文档将被忽略,不显示层级导航;
    • 通过文档上的og-hn-content属性,可自定义当前文档的内容显示顺序,属性值为字符串数组,例["info","breadcrumb","parent","sibling","previousAndNext","backlinks","child","widget", "previousAndNextPreview", "previewBox"];
  • 每个内容区默认限制高度(设置-外观、CSS-最大高度限制),右键内容区,可临时解除内容区高度限制;

快捷键说明

插件注册的快捷键可以到 思源设置-快捷键 处更改;

功能 默认快捷键 快捷键设置参考 备注
跳转到父文档(向上) ⌥⌘←Ctrl + Alt + ← 默认快捷键可能和网易云音乐全局快捷键冲突以下3个快捷键也有相同的问题
跳转到首个子文档(向下) ⌥⌘→Ctrl + Alt + →
跳转到上一篇文档(同层级) ⌥⌘↑Ctrl + Alt + ↑
跳转到下一篇文档(同层级) ⌥⌘↓Ctrl + Alt + ↓
当前块下方插入listChildDocs挂件 ⌥⇧LShift + Alt + L 需事先下载挂件
显示与当前文档相关文档导航 ⌥⌘ECtrl + Alt + E
置顶当前文档的层级导航区域 ⌥⌘QCtrl + Alt + Q 再次按下快捷键取消临时置顶

点击打开文档的同时按下快捷键:

  • Ctrl:在后台标签页打开;
  • Shift:在下侧分屏打开;
  • Alt: 在右侧分屏打开;

说明

  • 对于刚创建的文档,由于数据库更新延迟,可能不会显示导航区,切换页签之后将正常显示;

  • 如果启用插件后,在输入大量文字时卡顿,请检查及时更新设置项;出现显示延迟,请检查尽可能地显示文档图标、“反向链接文档名匹配正则表达式”等设置项;

反馈bug

(推荐)请前往github仓库反馈问题。

如果您无法访问github在此反馈

参考&感谢

代码贡献者(开发者)详见贡献者列表

依赖项详见package.json

开发者/项目 描述 说明
UFDXD/HBuilderX-Light 一个无边距的护眼主题 参考其标题下父子文档信息实现
leolee9086 / cc-template 使用挂件渲染模板;木兰宽松许可证, 第2版 点击打开文档
zuoez02/siyuan-plugin-system 插件系统
zxhd863943427&mozhux (赐我一胖) (github.com) 样式建议等
wetoria/DailyNotesWalker 快捷键快速查看上下一篇日记 参考其idea和快捷键绑定方式
(qq) 八面风, 与路同飞, (Github) QQQOrange,zhoutaosheng 帮助定位问题
Trilium / note-list-widget 预览方格内容区css样式和功能设计