Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
kb:debugging_broken_documents [2019/07/15 20:23] – dstillman | kb:debugging_broken_documents [2019/07/28 23:43] – dstillman | ||
---|---|---|---|
Line 3: | Line 3: | ||
If you can insert Zotero citations into new documents but receive an error in an existing document, follow these steps to find the cause of the error. | If you can insert Zotero citations into new documents but receive an error in an existing document, follow these steps to find the cause of the error. | ||
+ | - Make sure you're using the latest versions of Zotero and your word processor. | ||
- While troubleshooting, | - While troubleshooting, | ||
- Check for citations in image captions. Zotero won't let you insert them, but if you copied a citation to a caption that's most likely the source of the problem. Delete it. | - Check for citations in image captions. Zotero won't let you insert them, but if you copied a citation to a caption that's most likely the source of the problem. Delete it. | ||
Line 11: | Line 12: | ||
- If the document has a bibliography, | - If the document has a bibliography, | ||
- While debugging, if you are using Fields mode in Word or Reference Marks mode in LibreOffice, | - While debugging, if you are using Fields mode in Word or Reference Marks mode in LibreOffice, | ||
- | - **Isolate the problematic citations.** Delete half of the document at a time and see if the error still occurs. If not, use Undo to restore the deleted section and then try deleting the other half. Repeat the halving process on the section that fails, or pick one at random if both do. Continue this until you find smallest possible section, ideally with a single citation, that must be present for the problem to occur. Remove the isolated citations from the original document and the problem should go away (unless there are multiple broken citations, in which case you'll need to repeat the process). Unless the error still occurs if you completely clear the contents of the document, **this final step will by definition | + | - **Isolate the problematic citations.** Delete half of the document at a time and see if the error still occurs. If not, use Undo to restore the deleted section and then try deleting the other half. Repeat the halving process on the section that fails, or pick one at random if both do. Continue this until you find smallest possible section, ideally with a single citation, that must be present for the problem to occur. Remove the isolated citations from the original document and the problem should go away (unless there are multiple broken citations, in which case you'll need to repeat the process). Unless the error still occurs if you completely clear the contents of the document, **this final step will by definition |
If you encounter a broken document, please create a new thread in the [[/ | If you encounter a broken document, please create a new thread in the [[/ |