Add Errors and Fixes

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)