思源笔记丨写了一个插件,用块引实现脚注和备注

Github:Achuan-2/siyuan-plugin-blockref-footnote: 用块引实现脚注备注

✨ 功能

使用思源的块引实现脚注和备注功能

使用 Tsundoku 主题演示,对嵌套引述块样式进行了优化

📝 使用介绍

插件需要思源笔记版本 >3.1.12

本插件支持高度自定义化,支持的设置如下:

  • 脚注存放位置:可以设置存放在当前文档或者指定文档,默认为 当前文档

  • 选中文本的样式:可以为选中文本添加加粗、高亮、斜体、下划线样式,默认:无样式

  • 插入脚注的顺序:顺序或者倒序,默认:顺序

  • 脚注标题:设置存放脚注的标题名,默认:脚注

  • 脚注块引锚文本:设置脚注引用的锚文本,默认:

  • 脚注内容模板:设置脚注的模板,推荐使用引述块或超级块组合,保证脚注内容属于同一个块。 ${selection} 表示选中文本的内容,${content} 代表脚注内容占位

    • 嵌套引述块模板

      >> ${selection} >> > 💡${content}
    • 竖向超级块组合模板

      {{{row > ${selection} ${content} }}}

支持同时删除脚注引用和脚注内容,可以在脚注引用右键菜单,点击【插件-删除脚注】

🙏 致谢

❤️ 用爱发电

穷苦研究生在读ing,如果喜欢我的插件,欢迎给 GitHub 仓库点 star 和捐赠,这会激励我继续完善此插件和开发新插件。

  • 思源笔记

    思源笔记是一款隐私优先的个人知识管理系统,支持完全离线使用,同时也支持端到端加密同步。

    融合块、大纲和双向链接,重构你的思维。

    24829 引用 • 102140 回帖
2 操作
Achuan-2 在 2024-11-20 12:33:30 更新了该帖
Achuan-2 在 2024-11-19 12:49:35 更新了该帖

相关帖子

优质回帖
  • Achuan-2 2 1 赞同

    @participants

    v1.0.6 / 2024.11.20

    • ✨ 脚注内容模板新增 ${refID},代表选中文本所在的块 ID,现在可以通过模板插入选中文本所在的块链接了,方便在脚注内容里直接跳转到原来的块
      {{{row > ${selection} [[↩️]](siyuan://blocks/${refID}) ${content} }}} {: style="border: 2px dashed var(--b3-border-color);"}

    思源笔记脚注插件支持直接跳转到原来的块.gif

  • Achuan-2 1 1 赞同

    要用思源笔记 3.1.12dev 版本

    插件添加工具栏的 api 有变动,我用了最新的 api,不适配旧版本

  • Achuan-2 1 1 赞同

    @participants

    插件更新 v1.0.5 / 2024.11.20

    • ✨ 支持设置脚注块引为块超链接
    • ✨ 支持设置脚注放在子文档

    PixPin20241120212520.png

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...
  • zxhd86 1 评论

    不过我现在失去改进这个插件的兴趣了,因为 vv 搓了个大活,enhance 插件里的划词评论……不得不说在这件事上已经达到一个极致了。

    下面是视频链接:

    https://simplest-frontend.feishu.cn/minutes/obcnjq7455z25m2nnym3m4fs

    两个插件各有个的特点吧
    stevehfut
  • 其他回帖
  • Tisamn

    川佬,如果将脚注存放在当前文档底部,导出时无需再选择“将块引导出为脚注”的功能,否则会出现两个脚注,如下图所示:image.png

    在这个场景下我认为“链接型脚注”更合适一点(ps:唯一缺憾就是无法使用 pdf 的跳转功能)。

    所以,如果需要将文档导出为 pdf,这么选择更为合适:块引型脚注 + 将脚注存放在指定文档;如果无需导出 pdf 且将脚注置于文档底部,使用“链接型脚注”可以有效避免反链的重复~

    以上仅仅是个人观点,感谢川佬搞了一个这么 nice 的插件!

  • Achuan-2

    另外学习了下给超级块加边框的操作,改下默认模板

    {{{row > ${selection} ${content} }}} {: style="border: 2px dashed var(--b3-theme-on-background);"}

    PixPin20241120122654.png

    1 回复
    1 操作
    Achuan-2 在 2024-11-20 12:26:59 更新了该回帖
  • Achuan-2 1 via Android

    v1.1.1 / 2024.11.24 @@participants

    • ✨ 添加脚注引用的 css 样式
    • ✨ 脚注块引的自定义属性值改为脚注内容块 id custom-footnote="20241124013624-9oq7jfl",方便删除脚注内容块和为后面的脚注数字编号功能做准备
    • ✨ 选中文本的样式设置,取消加粗、高亮等原生样式,改用自定义样式。注意:如果有对重叠文字重复添加脚注的需求,请不要开启自定义样式,会有样式冲突问题。
    1 操作
    Achuan-2 在 2024-11-24 09:44:03 更新了该回帖
  • 查看全部回帖