Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
kb:debugging_broken_documents [2019/03/27 10:28] – Fix Report ID url adomasvenkb:debugging_broken_documents [2019/06/05 11:51] dstillman
Line 1: Line 1:
-If you receive an error when citing with Zotero please follow the troubleshooting steps below. Whether you manage to resolve your issue or not please submit a [[:reporting_problems#provide_a_report_id|Report ID]] from Zotero and create a new thread in the [[https://forums.zotero.org|Zotero Forums]] with the Report ID, your operating system and word processor versions, the steps you have attempted to fix the error and whether you were successful or not. +====== Troubleshooting errors in word processor documents ======
  
-====== Troubleshooting document updating errors ======+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. Whether you manage to resolve your issue or not, please submit a [[:reporting_problems#provide_a_report_id|Report ID]] from Zotero and create a new thread in the [[https://forums.zotero.org|Zotero Forums]] with the Report ID, your operating system and word processor versions, the steps you have attempted to fix the error, and whether you were successful.
  
-If you can insert citations into new documents but receive an error in an existing document, follow these steps to find the cause of the error: +    - While troubleshooting, disable the Track Changes feature in Word/LibreOffice, as it can have complicated effects when working with Zotero. If Track Changes is enabled when you insert or modify a Zotero citation, it may mark many or all of the Zotero citations in your document as changed or cause [[#field_codes_instead_of_citationbibiliography_text|field codes to be displayed]]. On rare occasions, Track Changes may cause Zotero to think a citation is corrupted. If you had Track Changes enabled previously, try accepting all changes to see if that resolves the issue.
- +
-    - While troubleshooting, disable the Track Changes feature in Word/LibreOffice, as it can have complicated effects when working with Zotero. If Track Changes is enabled when you insert or modify a Zotero citation, it may mark many or all of the Zotero citations in your document as changed or cause [[#field_codes_instead_of_citationbibiliography_text|field codes to be displayed]]. On rare occasions, Tracked Changes may cause Zotero to think a citation is corrupted. If you had Track Changes enabled previously, try accepting all changes to see if that resolves the issue.+
     - 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" button before your old citations will be recognized.     - 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" button before your old citations will be recognized.
     - Make a copy of your document — by duplicating the file itself, not by copying and pasting the content — to use for debugging.     - Make a copy of your document — by duplicating the file itself, not by copying and pasting the content — to use for debugging.
 +    - If using OneDrive on Windows, save the copy of the document to your local hard drive. OneDrive is known to interfere with the plugin for some people. If this fixes the problem for you, you can help us debug this conflict by posting to the [[/forum|Zotero Forums]].
     - Open the copied file and check if you get the error after switching to a different bibliography style.     - Open the copied file and check if you get the error after switching to a different bibliography style.
     - If the document has a bibliography, delete it and check if you still get the error.     - If the document has a bibliography, delete it and check if you still get the error.
-    - While debugging, if you are using Fields mode in Word or Reference Marks mode in LibreOffice, it may help to display field codes rather than formatted text. To do this press Alt/Option-F9 (or Alt/Option-Fn-F9) in Word or Ctrl-F9 in LibreOffice. +    - While debugging, if you are using Fields mode in Word or Reference Marks mode in LibreOffice, it may help to display field codes rather than formatted text. To do thispress Alt/Option-F9 (or Alt/Option-Fn-F9) in Word or Ctrl-F9 in LibreOffice. 
-    - **Try to isolate the problematic citation.** 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. If you can reproduce the error in only one of the halves, repeat the halving process on the remaining section. Continue this until you find the problematic citation. Remove that citation from the original document and the problem should go away (unless there are multiple problematic citations, in which case you'll have to repeat the process). If you are able to find a problematic citation, you should also send that document excerpt to support@zotero.org so we can take a look at it. For all other discussion, please post to the [[/forum|Zotero forums]]. +    - **Isolate the problematic citation.** 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. If you can reproduce the error in only one of the halves, repeat the halving process on the remaining section. Continue this until you find the problematic citation. Remove the broken citation from the original document and the problem should go away (unless there are multiple problematic citations, in which case you'll have to repeat the process). Unless the error still occurs if you completely clear the contents of the document, **this final step will by definition fix the problem.** \\ \\ If you are able to find a problematic citation, you should also send that document excerpt to support@zotero.org so we can take a look at it. For all other discussion, please post to the [[/forum|Zotero Forums]].
- +
- +
- +
kb/debugging_broken_documents.txt · Last modified: 2023/10/17 13:47 by dstillman