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
kb:debugging_broken_documents [2022/11/12 16:01] – dstillmankb:debugging_broken_documents [2024/12/02 03:10] (current) – Add an entry for Word macOS users about disabling clipboard software adomasven
Line 1: Line 1:
 ====== Troubleshooting Errors in Word Processor Documents ====== ====== Troubleshooting Errors in Word Processor Documents ======
 +
 +Follow the steps below for [[#microsoft_word|Microsoft Word]], [[#google_docs|Google Docs]], or [[#libreoffice|LibreOffice]].
 +===== Microsoft Word =====
  
 If you get an error trying to use Zotero in a **new, empty document**, see [[:word_processor_plugin_troubleshooting|Word Processor Plugin Troubleshooting]]. If you get an error trying to use Zotero in a **new, empty document**, see [[:word_processor_plugin_troubleshooting|Word Processor Plugin Troubleshooting]].
  
-If you can insert citations into a new, empty document but get an error using Zotero in an **existing document**, follow these steps:+If you can insert citations into a new, empty Word document but get an error using Zotero in an **existing document**, follow these steps:
  
-    - Restart both Zotero and your word processor. +    - Restart both Zotero and Word. 
-    - 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 Word. 
-    - 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 [[word_field_codes|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, 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 [[word_field_codes|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. 
-    - 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. +    - In Word Options → Advanced, make sure "Typing replaces selected text" is checked. 
-    - Try copying and pasting the document content into a new document (or using File → "Make a copy" in Google Docs) to see if the problem goes away. You may need to click the "Set Document Preferences" button before your old citations will be recognized.+    - If you use any clipboard enhancing software on macOS such as TextExpander, LaunchBar, Pure Paste, etc., temporarily disable 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.
     - 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, or try  renaming the file to remove any spaces in the filename. 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]].+    - If using OneDrive on Windows, save the copy of the document to your local hard drive, or try renaming the file to remove any spaces in the filename. OneDrive is known to interfere with the plugin for some people.
     - 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 completely and check if you still get the error.
 +    - While debugging, if you are using Fields mode in the Word plugin, 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.
 +    - **Isolate the problematic citations.** In the copy of your document, delete half of the contents 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 [[/forum|Zotero Forums]] so we can attempt to fix the issue. Include a [[:reporting_problems#provide_a_report_id|Report ID]] from Zotero, your operating system and Word versions, and the steps you've taken to try to fix the error. You should also send the document excerpt from Step 11 and a link to your forum thread to [[mailto:support@zotero.org|support@zotero.org]] so that we can try to reproduce the problem.
 +
 +===== Google Docs =====
 +
 +If you get an error trying to use Zotero in a **new, empty document**, see [[:google_docs#troubleshooting|Google Docs Troubleshooting]].
 +
 +If you can insert citations into a new, empty Google Doc but get an error using Zotero in an **existing document**, follow these steps:
 +
 +    - Restart both Zotero and your browser.
 +    - Make sure you're using the latest versions of Zotero and the Zotero Connector.
 +    - Disable any other browser extensions and reload Google Docs.
 +    - Try using File → "Make a copy" to see if the problem goes away in a new document. You may need to click the "Set Document Preferences" button before your old citations will be recognized.
 +    - In the copy of the document, 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. +    - **Isolate the problematic citations.** In the copy of your document, delete half of the contents 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.**
-    - **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 [[/forum|Zotero Forums]] so we can attempt to fix the issue. Include a [[:debug_output|Debug ID]] from the Zotero for reproducing the problem and the steps you've taken to try to fix the error. You should also make a sharing link for the document excerpt from Step 7 and email it to [[mailto:support@zotero.org|support@zotero.org]] with a link to your forum thread so that we can try to reproduce the problem.
 +
 +===== LibreOffice =====
 +
 +If you get an error trying to use Zotero in a **new, empty document**, see [[:word_processor_plugin_troubleshooting|Word Processor Plugin Troubleshooting]].
 +
 +If you can insert citations into a new, empty LibreOffice document but get an error using Zotero in an **existing document**, follow these steps:
 +
 +    - Restart both Zotero and LibreOffice.
 +    - Make sure you're using the latest versions of Zotero and LibreOffice.
 +    - While troubleshooting, disable the Track Changes feature in 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 [[word_field_codes|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.
 +    - 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.
 +    - Make sure your LibreOffice text style uses the same text style in the "Next Style" property.
 +    - 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.
 +    - 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.
 +    - While debugging, if you are using Reference Marks mode in the LibreOffice plugin, it may help to display field codes rather than formatted text by pressing Ctrl-F9.
 +    - **Isolate the problematic citations.** In the copy of the document, delete half of the contents 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 [[/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 11 and a link to your forum thread to [[mailto:support@zotero.org|support@zotero.org]] so that we can try to reproduce 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. Include a [[:reporting_problems#provide_a_report_id|Report ID]] from Zotero, your operating system and LibreOffice versions, and the steps you've taken to try to fix the error. You should also send the document excerpt from Step 11 and a link to your forum thread to [[mailto:support@zotero.org|support@zotero.org]] so that we can try to reproduce the problem.
kb/debugging_broken_documents.1668286886.txt.gz · Last modified: 2022/11/12 16:01 by dstillman