massivebox/siyuan-jsdraw-plugin
massivebox/siyuan-jsdraw-plugin
2
1
Fork 0
forked from mirrors/plugin-sample-vite-svelte
Code Issues 3 Pull requests Projects 2 Releases 8 Packages Wiki Activity Actions

Add Errors and Fixes

MassiveBox 2025-07-16 09:13:10 +00:00
parent 661bc21617
commit e2a29a3e86
1 changed files with 31 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

31
Errors-and-Fixes.md Normal file

@ -0,0 +1,31 @@
# Errors and Fixes
In this page, you can find the solutions for most of the issues you may run into while using the Plugin.
If you run into any other problem, or the proposed solutions don't work, please [open an issue!](https://git.massive.box/massivebox/siyuan-jsdraw-plugin/issues/new)
## Multiple SyncIDs found
This error occurs when a file exists with the same FileID, but different SyncIDs in your documents.
> **What are FileID and SyncID?**
>
> SiYuan file names look like this: `example-20250715151703-vgeh422.svg`
>
> - The part before the timestamp is the **FileID**, in this case `example`
> - The rest before the extension is the **SyncID**, in this case `20250715151703-vgeh422`
>
> When editing a whiteboard with the Plugin, the FileID stays the same, but the SyncID changes to avoid conflicts.
> When renaming an asset via the SiYuan menu, you are only changing its FileID.
**This error can occur when:**
- You've used the same FileID twice for two different whiteboards (for example, the filenames are `assets/hello-20250624211542-jhhgosf.svg` and `assets/hello-20250506181709-11vpo0e.svg`)
- A file sync conflict copy was generated as you were editing a whiteboard, so the conflict copy contains a different SyncID, but the same FileID, as the original whiteboard.
**This error can not occur when:**
- Copying and pasting the same whiteboard more than once in your document. You can have as many copies of the same whiteboard as you like.
**How to fix it**: Try these solutions from top to bottom and try to open the editor after each step.
- Delete sync conflict files that contain the same whiteboard you're trying to edit, if they exist
- Rename the whiteboard you're trying to edit: Right-click it (or click the 3-dots button on mobile), then click Rename, and enter an unique name, which is not used in any other whiteboard
- Check that the whiteboard FileID is not used in any other whiteboard, including in "dead" whiteboards (those who are referenced in documents, but don't contain an image)