From e2a29a3e864bed4a09fa00444b4f53da7fe59cf9 Mon Sep 17 00:00:00 2001 From: MassiveBox Date: Wed, 16 Jul 2025 09:13:10 +0000 Subject: [PATCH] Add Errors and Fixes --- Errors-and-Fixes.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 Errors-and-Fixes.md diff --git a/Errors-and-Fixes.md b/Errors-and-Fixes.md new file mode 100644 index 0000000..ecbee6c --- /dev/null +++ b/Errors-and-Fixes.md @@ -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) \ No newline at end of file