Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
word_processor_plugin_troubleshooting [2018/12/04 05:31] – [Windows] Update manual installation link adomasven | word_processor_plugin_troubleshooting [2019/11/26 05:43] – dstillman | ||
---|---|---|---|
Line 14: | Line 14: | ||
- Close Word or LibreOffice. | - Close Word or LibreOffice. | ||
- In Zotero, go to Tools → Add-ons → Extensions. | - In Zotero, go to Tools → Add-ons → Extensions. | ||
- | - If " | + | - Make sure " |
- | - If the " | + | - If the " |
- | - If you don't see " | + | - If you don't see the required integration plugin |
- | - In the [[/ | + | - In the [[/ |
- | - Click “Reinstall | + | |
If you are still experiencing issues, follow these software specific troubleshooting steps: | If you are still experiencing issues, follow these software specific troubleshooting steps: | ||
- | * [[#windows|Word for Windows]] | + | * [[#zotero_tab_does_not_appear_in_the_word_ribbon|Word for Windows]] |
- | * [[#tab_does_not_appear_in_word_2016|Word 2016 for Mac]] | + | * [[#tab_does_not_appear_in_word_20162019|Word 2016/2019 for Mac]] |
* [[# | * [[# | ||
* [[# | * [[# | ||
Line 29: | Line 28: | ||
===== Debugging broken documents ===== | ===== Debugging broken documents ===== | ||
- | 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: | + | See [[https://www.zotero.org/ |
- | + | ||
- | - 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. | + | |
- | - 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" | + | |
- | - 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, | + | |
- | - Check " | + | |
- | - **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 | + | |
- | - While debugging, if you are using Fields mode in Word or Reference Marks mode in LibreOffice, | + | |
===== Field codes instead of citation/ | ===== Field codes instead of citation/ | ||
Line 46: | Line 34: | ||
===== Citations/ | ===== Citations/ | ||
- | Word and LibreOffice will highlight Fields/ | + | See [[kb/ |
- | + | ||
- | You can change the settings for highlighting Fields/ | + | |
- | * **[[https:// | + | |
- | * **Word for Mac:** Open Word -> Preferences -> View and set "Field shading" | + | |
- | * **[[https:// | + | |
- | + | ||
- | See also [[kb/ | + | |
===== Citations converted to plain text ===== | ===== Citations converted to plain text ===== | ||
- | If you have previously inserted citations into Word or LibreOffice using Zotero, but they have now been converted to plain text, this may be caused by one of several factors. | + | See [[kb/ |
- | + | ||
- | - You used the " | + | |
- | - You saved the document in an unsupported file type. For Word, your document must be saved as .docx or .doc. For LibreOffice, | + | |
- | - You opened and saved your document using a word processor program that does not support Fields/ | + | |
- | - **Google Docs and other online word processors: | + | |
- | - **Pages:** Apple Pages does not support Fields/ | + | |
- | - **Word:** If you open an .odt file (created by LibreOffice) in Word, Zotero references stored as Reference Marks (the default) will be broken. To share a document between Word and LibreOffice users, change the "Store Citations as:" option in the Zotero Document Preferences to Bookmarks. (Bookmarks can cause errors if accidentally modified, so they should only be used if compatibility between Word and LibreOffice is necessary.) | + | |
- | - **LibreOffice: | + | |
- | + | ||
- | If your document' | + | |
- | + | ||
- | See also [[kb/ | + | |
====== Word ====== | ====== Word ====== | ||
Line 99: | Line 68: | ||
- Choose " | - Choose " | ||
- On the right pane tick the " | - On the right pane tick the " | ||
- | - Close the options and in the new Developer tab click "Word Add-ins" | + | - Close the options and in the new Developer tab in the ribbon |
- Make sure Zotero.dotm is present and ticked | - Make sure Zotero.dotm is present and ticked | ||
Line 113: | Line 82: | ||
** If Zotero.dotm is not present under Word Add-ins ** | ** If Zotero.dotm is not present under Word Add-ins ** | ||
- | - Go into Zotero | + | - In Zotero, go to Tools → Add-ons and make sure that Zotero Word for Windows Integration is enabled. If it is disabled, enable it and restart Word. |
- If Zotero Word for Windows Integration is missing entirely from the Add-ons window, see [[# | - If Zotero Word for Windows Integration is missing entirely from the Add-ons window, see [[# | ||
- | - Go into Zotero Preferences | + | - In Zotero, go to Edit → Preferences |
If Zotero tab is not present in Word, check whether it is available under Word Add-ins and if so, follow the section above. If it still does not show up in Word Add-ins, you should attempt a [[/ | If Zotero tab is not present in Word, check whether it is available under Word Add-ins and if so, follow the section above. If it still does not show up in Word Add-ins, you should attempt a [[/ | ||
Line 132: | Line 101: | ||
You may also experience this error if you are running either Word or Zotero as Administrator or in a compatibility mode in Windows Vista or 7, or if security software is interfering with Zotero' | You may also experience this error if you are running either Word or Zotero as Administrator or in a compatibility mode in Windows Vista or 7, or if security software is interfering with Zotero' | ||
+ | |||
+ | |||
+ | ==== Run-time error ' | ||
+ | This issue affects the users of the Windows 10 October 2018 Update. To fix it you will need to change your regional format to English: | ||
+ | |||
+ | - In “Windows settings” go to the page for “Region”, | ||
+ | - Change that setting to " | ||
+ | - Restart Word | ||
Line 143: | Line 120: | ||
===== Mac ===== | ===== Mac ===== | ||
- | ==== Tab does not appear in Word 2016 ==== | + | ==== Tab does not appear in Word 2016/2019 ==== |
First, check your [[https:// | First, check your [[https:// | ||
Line 310: | Line 287: | ||
This is usually caused by an outdated version of LibreOffice that does not properly locate the system Java installation. It can be resolved by installing [[http:// | This is usually caused by an outdated version of LibreOffice that does not properly locate the system Java installation. It can be resolved by installing [[http:// | ||
- | ==== LibreOffice | + | ==== LibreOffice on macOS 10.11+: No response from plugin ==== |
- | Problem: LibreOffice | + | Problem: LibreOffice does not currently recognize the Java Runtime Environment (JRE), and Zotero' |
Solution: Uninstall the JRE and install the Java Development Kit (JDK) instead. | Solution: Uninstall the JRE and install the Java Development Kit (JDK) instead. | ||
- Uninstall the JRE | - Uninstall the JRE | ||
- | - Download and install [[http:// | + | - Download and install |
- In LibreOffice: | - In LibreOffice: | ||
- | - Check in Prefs -> Advanced | + | - In Preferences |
- Go to Tools -> Extension Manager, scroll down to “Zotero LibreOffice Integration", | - Go to Tools -> Extension Manager, scroll down to “Zotero LibreOffice Integration", | ||
- After enabling, the Zotero buttons in the LibreOffice toolbar should be responsive. | - After enabling, the Zotero buttons in the LibreOffice toolbar should be responsive. | ||
- | Tested successfully with LibreOffice | + | Tested successfully with LibreOffice |
===== Linux ===== | ===== Linux ===== |