Differences

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

Link to this comparison view

Both sides previous revision Previous revision
kb:debugging_broken_documents [2019/07/23 07:01]
dstillman
kb:debugging_broken_documents [2019/07/28 23:43] (current)
dstillman
Line 12: Line 12:
     - 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 this, press Alt/​Option-F9 (or Alt/​Option-Fn-F9) in Word or Ctrl-F9 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 ​fix 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 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 [[/​forum|Zotero Forums]] so we can attempt to fix the issue. Be sure to include a [[:​reporting_problems#​provide_a_report_id|Report ID]] from Zotero, your operating system and word processor versions, the steps you have attempted to fix the error, and whether you were successful. You should also send the document excerpt from Step 9 and a link to your forum thread to [[mailto:​support@zotero.org|support@zotero.org]] so that we can take a look. If you encounter a broken document, please create a new thread in the [[/​forum|Zotero Forums]] so we can attempt to fix the issue. Be sure to include a [[:​reporting_problems#​provide_a_report_id|Report ID]] from Zotero, your operating system and word processor versions, the steps you have attempted to fix the error, and whether you were successful. You should also send the document excerpt from Step 9 and a link to your forum thread to [[mailto:​support@zotero.org|support@zotero.org]] so that we can take a look.
kb/debugging_broken_documents.txt ยท Last modified: 2019/07/28 23:43 by dstillman