[思源笔记经验分享] 差异化对比编辑历史记录与自动补全 Katex 公式

简介

主题 Dark+ 在 v1.3.0 大版本更新中来了两个大功能

• 使用文本编辑器 Monaco Editor 的差异编辑器对比编辑历史记录与当前文档的 Markdown/Kramdown 源代码

  • 实现方案

    • Monaco Editor 内置的差异编辑器 monaco.editor.createDiffEditor

• 参考 vscode 插件 Markdown All in One 实现 Katex 公式的自动补全提示

  • 参考

    • vscode-markdown/completion.ts at master · yzhang-gh/vscode-markdown

  • 实现

    • siyuan-theme-dark-plus/completion.js at main · Zuoqiu-Yingyi/siyuan-theme-dark-plus

如果喜欢这些功能, 欢迎为 Dark+ 点一个 ⭐ (*^▽^*)

使用教程

差异化对比编辑历史记录 Markdown/Kramdown 源代码

• 打开历史对话框(使用快捷键Alt + H或点击窗口左上的数据历史按钮)

• 历史对话框切换到文件历史页签

• 使用Alt + 鼠标中键单击某个历史文件在新窗口打开 Monaco Editor 的差异编辑器, 左侧只读编辑器内容为为所点击历史文件对应的 Markdown 源码, 右侧可编辑的编辑器内容为当前文档的 Markdown 源码

  • ​
  • 由于 Markdown 文本会丢失思源的块属性(例如块 ID, 块更新时间等), 因此本模式右侧编辑器编辑后的内容无法直接保存, 但是可以更好地查看文档的内容变更

• 使用Shift + Alt + 鼠标中键单击某个历史文件在新窗口打开 Monaco Editor 的差异编辑器, 左侧只读编辑器内容为为所点击历史文件对应的 Kramdown 源码, 右侧可编辑的编辑器内容为当前文档的 Kramdown 源码

  • ​
  • 由于 Kramdown 的 IAL 中的字段顺序不一定完全一致, 因此本模式部分内容一致但属性顺序不一致的 IAL 也会显示出差异
  • 由于 Kramdown 可以保存思源的块属性信息, 因此右侧编辑器编辑后的内容可以直接保存(使用快捷键Ctrl + S或右键菜单保存)

自动补全 Katex 公式

• 使用Alt + 鼠标中键或Shift + Alt + 鼠标中键单击某个叶子块或使用Shift + Alt + 鼠标中键单击某个容器块

• 在新窗口打开的编辑器中输入行内公式(需要使用 $ 包裹)或公式块(需要使用 $$ 包裹)即可弹出 Katex 公式关键字的自动补全

  • ​
  • 输入 \ 时会触发
  • 输入完成后别忘了使用快捷键Ctrl + S或右键菜单项保存

使用

• 若不使用 Dark+ 主题, 可以下载该主题 v1.3.0+ 版本, 将 Dark+ 主题目录下的 theme.js 文件 复制 到所使用的其他主题的目录下