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 [2020/01/06 22:07] – dstillman | kb:debugging_broken_documents [2020/10/09 13:43] – dstillman | ||
---|---|---|---|
Line 4: | Line 4: | ||
- Make sure you're using the latest versions of Zotero and your word processor. | - 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. | ||
- Try copying and pasting the document content into a new document to see if the problem goes away. You may need to click the "Set Document Preferences" | - Try copying and pasting the document content into a new document to see if the problem goes away. You may need to click the "Set Document Preferences" | ||
Line 12: | 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 identify the problem.** | + | - **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 the 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 identify the problem.** |
- | 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 [[/ |