调试时对应的笔记版本：V3.0.3

修复预览文档中的数据表格渲染问题：

• 表头使用自定义图标（非默认图标）时会导致该表格渲染失败。
• 【超链接】列的链接点击后无法跳转。
• 【关联】列单元格内容未能正常渲染
• 【创建时间】、【更新时间】列会导致该表格渲染失败。

样式修改：

• 【保存】、【刷新】按钮字号调小，跟旁边的【素材库】保持一致，看起来协调一点。
• 拖拽进白板的嵌入文档：文档边框颜色调淡一点（由#1e1e1e调为#c0c0c0）
• 拖拽进白板的嵌入文档：边角默认用直角，不再跟随当前状态，避免出现文档模糊的问题。

对于当前版本：V1.2.1

如果你不想默认开启自动保存功能，可以使用VS Code之类的编辑器打开挂件文件夹Whiteboard——index.html，

搜索：

window._autoSave = true;

改成：

window._autoSave = false;

如果你想调整自动保存的延时时间（默认是2000ms），可以打开挂件文件夹Whiteboard​——assets​——index-c894b550.js​

搜索：

window._isDarwin?document.dispatchEvent(new KeyboardEvent("keydown",{key:"S",metaKey:!0,bubbles:!1})):document.dispatchEvent(new KeyboardEvent("keydown",{key:"S",ctrlKey:!0,bubbles:!1}))},2000));

将最后那个数值：2000 改成你想设置的数值即可，单位是毫秒。

• 删掉sourcemap文件，减小挂件包的体积。
• 预览文档中支持渲染嵌入块。
• 预览文档中支持渲染数据库表格视图（Database table view）。
• 优化消息弹窗，加上时间戳并在样式上减少干扰，保留最后一个通知。
• 白板中预览文档的样式调整：减少文档内边距（边缘空白），theme.css中引入了超链接图标。

Tips:

1. 预览文档如果在翻页或者鼠标滚动过程中出现模糊，可以先把鼠标移出Web-Embed框来恢复清晰度。
2. 如果预览文档中有Mermaid图表，建议保存的时候让对应的文档处于白板可视区域内（通过白板的缩小等方式），这样下次打开的时候能保证正常渲染。
3. 在白板中渲染数据库表格视图的时候虽然没有滚动条，但是可以通过shift+鼠标滚轮的方式来横向滚动查看数据表格。

• 样式调整：对Web-Embed​中嵌入的文档，基础字体大小从14px调整为16px。

• 支持通过拖拽的方式快速嵌入文档/块。

  • 需要先添加一个JS代码片段来辅助获取当前拖拽块的ID。（见下方的代码块），在笔记软件的设置​——外观​——代码片段​——JS​中添加。

  • 1、使用拖拽方式来嵌入文档

    • 在文档树，鼠标左键按住文档后往白板拖拽即可。

  • 2、使用拖拽方式来嵌入块

    • 建议先分屏，白板在左侧，文档在右侧。（白板此时建议开启禅模式​，以减少编辑栏弹出带来的干扰）
    • 文档处于编辑状态。
    • 鼠标悬浮在块上方时，块的左上角显示块标，鼠标左键按住块标后往白板拖拽即可。

document.addEventListener("dragstart", (event) => {
    if (event.target.tagName === "SPAN" && event.target.parentElement.getAttribute('data-node-id')) {
        window._currentBlockID = event.target.parentElement.getAttribute('data-node-id');      
    } else if (event.target.tagName === "LI" && event.target.getAttribute("data-node-id")) {
        window._currentBlockID = event.target.getAttribute("data-node-id");  
    } else {
        window._currentBlockID = null;
    }
}
);

• 修复样式问题：在移动端，【保存】、【刷新】按钮无法自动调整位置导致被遮挡。
• 关于全屏快捷键在Excalidraw V0.17.0被移除的问题 。新增全屏快捷键Alt+Y，这个快捷键跟笔记里其他文档的全屏快捷键保持一致，点击白板空白处后，按该快捷键可进入/退出全屏模式。

Web-Embed相关：

• 如果嵌入的是文档的块超链接，则自动插入文档标题。
• 预览文档中支持渲染katex公式、Mermaid。
• 对于预览文档中的嵌入块，就不继续查询渲染了，处理为直接显示对应的SQL 文本。

• Excalidraw版本升级，0.15.0——>0.17.0

• 支持嵌入笔记内文档（预览的形式，不可编辑），效果见顶部那个预览图。

  基本用法：

  • 白板顶部工具栏有个【嵌入网页】的功能，点击后按住鼠标拖拽出一个Web-Embed的框，然后把笔记内的块超链接【形如：siyuan://blocks/20200812220555-lj3enxa】粘贴进链接框并回车，然后随便挪动一下鼠标就开始渲染那个块/文档了。
  • 在Web-Embed框里要滚动页面查看内容的话，需要先把鼠标挪到框中央并点击按钮【点击开始交互】，框里的块引用、超链接点击能跳转。
  • 预览的文档里有些块还没处理，像公式、HTML块、Mermaid、嵌入块等，但目前用来看个大概还是可以的。
  • 如果刚打开白板或者刷新后看到那个Web-Embed框是空白的，只需要在白板里随便挪一下鼠标就开始渲染了。
  • Web-Embed框的边角建议用直角，有弧度的那个边角可能会导致文档模糊。
  • 预览的文档所用的主题样式就在挂件文件夹Whiteboard\theme\theme.css里。

• 去掉【清除文字之间的空格】功能；

• 自动保存延时改为2s，自动保存也会弹窗提醒（不提醒一下都不知道有没有保存），同时为了减少干扰，已将弹窗的颜色调的很淡。

• 自动保存开启/关闭的快捷键改为Alt+F，主要是因为新版的Alt+S快捷键被功能【吸附至对象】占用了。

• 白板文档作为嵌入块出现在其他文档时，底部可能有空行，让白板看起来不好看，可用CSS片段来隐藏掉：

   /* 白板嵌入块——隐藏底边的空白行 */
   .protyle-wysiwyg__embed > .iframe[custom-data-assets^="assets/ExcalidrawFiles/"] + .p{
     display:none;
   }

• 前面的版本打开白板时还是有几个重复的加载消耗，这个版本主要是删除掉那些冗余部分。这版打开应该会流畅些。

• 修复问题：在移动端，白板文档作为嵌入块时显示不全。【之前修复的部分是PC端的，忘了移动端，最近看到才发现】。
• 在白板文档中，文档树右侧（调整页面宽度）的拖拽线被遮挡。

这个问题添加CSS片段即可，白板的z-index层级不能再调低了，不然有时遮不住挂件的块标，会很难看，所以可以把拖拽线的层级调高。

.layout__resize--lr {
    z-index: 3;
}

• 自动保存的延时默认值调整为2500ms。

虽然有防抖，但是之前设置的默认值1.5s还是太小了，可能造成卡顿等问题，而且最近使用的时候发现，白板上鼠标右键弹出的菜单如果碰上自动保存会收起来。所以如果碰上卡顿或者鼠标右键弹出的菜单被收起，建议关掉自动保存（快捷键Alt+S）。

• 去掉刚打开白板时触发的那次自动保存，减少不必要的性能消耗，这样打开白板时更流畅些。
• 处理问题：在macOS端保存按钮失效的问题。

• 减少自动保存时弹窗的干扰。

触发自动保存时不弹出【已保存】的消息提醒；

手动点击保存按钮、键盘上按Ctrl+S依旧保留弹窗提醒。

• 默认开启自动保存功能，编辑结束1.5s后自动保存数据。

如果觉得弹窗太分散注意力，可以点击空白处后，使用快捷键Alt+S开启/关闭【自动保存功能】，左上角会有消息提示。 一般会在初始化时，增、删或移动元素时触发自动保存。

• 修复问题：禁用白板默认的自动聚焦功能；

白板默认的自动聚焦行为会导致页面中出现抢焦点的问题。具体表现为：

• 在搜索界面，当结果预览界面出现白板时，焦点会转移到画板，导致搜索输入框失去焦点。如果需要继续输入关键词，你需要重新点一下输入框后才能继续输入，这点非常烦人。禁用后则无此问题。
• 在含有白板所在文档的嵌入块的页面中，白板的自动聚焦会跟笔记软件本身的【滚动到上次浏览位置】冲突，导致页面不能滚动到上次浏览的位置。

• 修复问题：将白板以嵌入块形式嵌入到其他文档时显示不完全

• 首次提交

一个基于Excalidraw的挂件，嵌入后会自动铺满文档，将一个文档当成一个白板。融合了块悬浮预览、关键词搜索定位、画板内不同元素之间的跳转等小功能。

可通过引用文档的方式来引用白板。如果需要将画好的白板导出并分享给别人，可以使用白板所在文档的导出/导入SiYuan .sy.zip​文件的功能。每个白板绑定一个存储在assets/ExcalidrawFiles/中的文件，文档删除后白板绑定的文件也会作为【未引用的资源】来方便手动删除。

白板创建时，会自动设置所在文档的属性——别名​​的值为：whiteboard​​，这是为了解决打开白板所在文档时页面闪现出文档标题的问题。相应的，你需要在笔记软件的设置​​——外观​​中添加对应的CSS代码片段：

/* 白板挂件——隐藏当前文档的标题、面包屑 */
.protyle-title.protyle-wysiwyg--attr:has(+ .protyle-wysiwyg.protyle-wysiwyg--attr[alias="whiteboard"]){
 visibility: hidden;
}

.protyle-breadcrumb:has(+ .protyle-content.protyle-content--transition > .protyle-wysiwyg.protyle-wysiwyg--attr[alias="whiteboard"]) {
   visibility: hidden;
}

为了美观，还需要隐藏掉挂件默认的边框：

/* 挂件——去掉边框 */
.b3-typography iframe, .protyle-wysiwyg iframe {
    border: none;   
}

还有一个可选的样式，是设置悬浮窗大小的，个人感觉默认的窗口有点过于宽了才设置的，这个不重要，你可以根据自己的需要来决定是否添加。

/* 悬浮窗口 */
.block__popover {
    width: 735px;
    border: 1px solid #94949482;
    min-height: 70vh;
    max-height: 75vh !important;
}

• 安装这个插件是为了能在白板中悬浮预览笔记内块/文档的内容。
• 在设置​​​——集市​​​——​插件​​​页面，下载并启用插件开放 API​​​即可。

‍

下载完挂件后，在新建的空白文档中输入/g​​​并回车，在挂件列表选择Whiteboard​​​即可在当前文档中插入白板，默认铺满文档。

单击左上角的保存​​​按钮或者使用快捷键Ctrl​​​+S​​​来保存白板的数据。左上角会弹出提示：已保存​​​​​​​

白板的数据保存在：assets/ExcalidrawFiles/ ​​​​​文件夹中，文件路径类似于：

assets/ExcalidrawFiles/20231227015401-w0olmpi.excalidraw

使用白板挂件块的ID作为文件名。

编辑完后记得点击保存、记得点击保存、记得点击保存，不然什么都没了。 我自己比较勤按Ctrl+S，所以目前还没丢过内容。

• 在白板中插入链接的方式没有变化：先复制一个链接地址（外部链接或者某个块/文档的块超链接​​​​​），在画板中点击选中一个元素后按Ctrl​​​​​+K​​​​​后弹出链接输入框，粘贴链接并回车即可。
• 值得注意的是，如果插入的是块超链接，并且想在白板中悬浮预览该块的内容，你需要先打开预览开关。先单击白板空白处，然后按快捷键Alt​+Q​是开启预览，按快捷键Alt​+W​是关闭预览。默认是关闭的，在开启状态下，鼠标悬浮在白板中某个元素的链接图标上时，能弹出悬浮窗来预览该块的内容，弹出窗口后可通过按ESC​键（若不生效可先点击一下预览的文档）或者鼠标点击右上角X​来关闭窗口。

• 可通过搜索框来搜索、定位白板内的文字，支持多个关键字（以空格隔开）。想要定位准的话需要画板重置缩放比例为：100%，在左下角设置。
• 搜索前建议先确认内容已经保存，因为搜索的内容是从保存的白板文件中读取的，如果你新增了内容且没保存，那么搜索到的结果可能是不全的。
• 先单击白板空白处获得焦点，然后按快捷键​Alt​​+T​​​​就可以唤出/关闭搜索框。唤出后点击白板空白处也可以关闭搜索框。
• 唤出的搜索框自动获取焦点，此时可以直接输入要查询的关键字，关键字之间以空格隔开，匹配到的结果会在约0.5s后显示在下方列表中。
• 弹出匹配的结果后，搜索框仍获得焦点，此时通过键盘的上、下方向键可以切换并定位匹配结果的位置。当然， 你还可以直接鼠标单击某个匹配的结果来定位它的位置。

• 比如：画板内要从元素A跳转到元素B。（此时画板缩放比例为：100%）

• 先选中元素B，按​Ctrl​​​​+​C​​​​来复制该元素，然后单击选中元素A，按住​Ctrl​​​​后，依次按​J​​​​、​K​​​​、​V​​​​后回车，即可生成链接。

  • 这个过程中，​Ctrl​​​​+​J​​​​是从刚刚复制的元素中获取元素ID，生成类似：excalidraw://nFrmqWgyT-lXdsS15Yswu​​​​这样的链接并复制到剪切板，此时左上角会提示：已将链接复制到剪切板。
  • 后面的​Ctrl​​​​+​K​​​​弹出链接输入框，​Ctrl​​​​+V​​​​粘贴就是常规的插入链接的方式了。

• 单击元素A上的链接图标，即可跳转到元素B的位置。（只适用于画板内，在画板外使用该链接并不能跳转）

• 如果跳转失败，可以先点击下【保存】按钮后再试试。

对于版本V1.2.1，打开挂件文件夹Whiteboard​——assets​——index-c894b550.js​,在该js文件中搜索：

simulatePressure:e.simulatePressure,size:e.strokeWidth*1.2,thinning

那个1.2是现在设置的值（已经相对小了），最开始的默认值是4点几，你可以根据自己需要更改这个值的大小来修改画笔的粗细。

如果白板的素材库​​​​用的比较多的话，最好设置笔记的固定端口启动，因为添加进素材库的内容都是存到LocalStorage中的，设置后已添加到素材库的内容就不会在下一次启动后不显示了。

鼠标右键笔记桌面图标——属性​​​​——快捷方式​​​​——目标(T)​​​​，在目标(T)​​​​这栏的输入框中，是思源笔记可执行文件的路径，比如：

D:\Siyuan\SiYuan.exe

在后面指定端口即可，比如：

D:\Siyuan\SiYuan.exe  --port=6806

• Excalidraw项目
• 画板中的中文字体文件拷贝自 superdraw 项目；
• 感谢插件【开放 API】的作者Zuoqiu-Yingyi。

‍