| Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
| word_processor_plugin_troubleshooting [2019/04/02 11:56] – [Debugging broken documents] dstillman | word_processor_plugin_troubleshooting [2019/11/26 15:13] – [Zotero toolbar doesn't appear] dstillman |
|---|
| - 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 "Zotero Word for Mac/Windows Integration" or "Zotero LibreOffice Integration" are disabled, click the "Enable" button to re-enable the extension. | - Make sure "Zotero Word for Mac", Zotero for Windows Integration", and/or "Zotero LibreOffice Integration" are enabled. If any are not, click the "Enable" button. |
| - If the "Enable" button for "Zotero Word for Mac/Windows Integration" is grayed out, and you are unable to click it, click the "Remove" button and restart Zotero. | - If the "Enable" button is grayed out and you are unable to click it, click the "Remove" button and restart Zotero. |
| - If you don't see "Zotero Word for Mac/Windows Integration" or "Zotero LibreOffice Integration" in the Extensions window at all, then you should [[/download|re-download]] and re-install Zotero. It is not necessary to uninstall Zotero before re-installing; simply install Zotero over the top of the existing installation. (**Note:** Re-installing Zotero rarely fixes problems and should not be used as a general troubleshooting step. This is one of the few instances where re-installation is helpful.) | - If you don't see the required integration plugin in the Extensions pane at all, then you should [[/download|re-download]] and re-install Zotero. It is not necessary to uninstall Zotero before re-installing; simply install Zotero over the top of the existing installation. (**Note:** Re-installing Zotero rarely fixes problems and should not be used as a general troubleshooting step. This is one of the few instances where re-installation is helpful.) |
| - In the [[/preferences/cite|Cite pane]] of Zotero preferences, open the "Word Processors" tab. | - In the [[/preferences/cite|Cite pane]] of the Zotero preferences, open the "Word Processors" tab, click “Reinstall Microsoft Word Add-in” or “Reinstall LibreOffice Add-in”, and then restart your word processor. |
| - Click “Reinstall LibreOffice/Microsoft Word Add-in” and then restart your word processor. | |
| |
| 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]] |
| * [[#toolbar_does_not_appear_in_word_2011_or_is_incompatible|Word 2011 for Mac]] | * [[#toolbar_does_not_appear_in_word_2011_or_is_incompatible|Word 2011 for Mac]] |
| * [[#scripts_do_not_appear_in_word_20082011_or_are_incompatible|Word 2008/2011 for Mac]] | * [[#scripts_do_not_appear_in_word_20082011_or_are_incompatible|Word 2008/2011 for Mac]] |
| ===== Debugging broken documents ===== | ===== Debugging broken documents ===== |
| |
| See [[https://www.zotero.org/support/kb/debugging_broken_documents|Troubleshooting errors in word processor documents]]. | See [[kb:debugging_broken_documents|Troubleshooting errors in word processor documents]]. |
| ===== Field codes instead of citation/bibiliography text ===== | ===== Field codes instead of citation/bibiliography text ===== |
| |
| ===== Citations/bibliography highlighted ===== | ===== Citations/bibliography highlighted ===== |
| |
| Word and LibreOffice will highlight Fields/Reference Marks on your screen to indicate that the text is automatically generated. This can help you avoid accidentally manually typing in the fields (to edit the text shown in a Zotero citation, see [[/support/word_processor_plugin_usage#customizing_cites|Customizing Cites]]). These highlights are only shown on screen and won't appear if you print or save the document as a PDF. | See [[kb/citations_highlighted|Citations Highlighted]]. |
| | |
| You can change the settings for highlighting Fields/Reference Marks in your word processor: | |
| * **[[https://helpdeskgeek.com/office-tips/show-field-shading-in-word-and-convert-the-fields-to-plain-text/|Word for Windows]]:** In Word Options, open "Advanced", then set "Field shading" to "Never", "Always", or "When selected". | |
| * **Word for Mac:** Open Word -> Preferences -> View and set "Field shading" to "Never", "Always", or "When selected". | |
| * **[[https://help.libreoffice.org/Writer/About_Fields|LibreOffice]]:** Open Tools -> Options -> LibreOffice -> Application Colors and check/uncheck the "Field shadings" box. You can also control the color used for field shadings. | |
| | |
| See also [[kb/citations_highlighted|Citations Highlighted]]. | |
| |
| ===== 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/citations_converted_to_plain_text|Citations Converted to Plain Text]]. |
| | |
| - You used the "Unlink Citations" button. This button will disconnect your document from Zotero and convert all citations and bibliographies to plain text. | |
| - You saved the document in an unsupported file type. For Word, your document must be saved as .docx or .doc. For LibreOffice, if you are storing citations as Reference Marks (the default), your document must be saved as .odt. For LibreOffice, if you are storing citations as Bookmarks (see below), your document must be saved as .docx or .doc. | |
| - You opened and saved your document using a word processor program that does not support Fields/Reference Marks/Bookmarks. These include: | |
| - **Google Docs and other online word processors:** Google Docs and most other online word processors do not support Fields/Reference Marks/Bookmarks. Opening a document in these programs will break connections with Zotero. Microsoft's Word Online does support Fields and so can be used safely with Word documents containing Zotero fields. | |
| - **Pages:** Apple Pages does not support Fields/Reference Marks/Bookmarks. Opening a document in Pages will break connections with Zotero. | |
| - **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 you open a .docs or .doc file (created by Word) in LibreOffice, Zotero references stored as Fields (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.) | |
| | |
| If your document's citations have been converted to plain text, your only option for restoring the links to Zotero is to open and restore a previous version of the document with the citation links intact. If this is not possible, you will need to re-insert the citations from Zotero. | |
| | |
| See also [[kb/citations_converted_to_plain_text|Citations Converted to Plain Text]]. | |
| |
| ====== Word ====== | ====== Word ====== |
| - Choose "Customize Ribbon" | - Choose "Customize Ribbon" |
| - On the right pane tick the "Developer" tab | - On the right pane tick the "Developer" tab |
| - 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 click "Word Add-ins" |
| - Make sure Zotero.dotm is present and ticked | - Make sure Zotero.dotm is present and ticked |
| |
| ** If Zotero.dotm is not present under Word Add-ins ** | ** If Zotero.dotm is not present under Word Add-ins ** |
| |
| - Go into Zotero -> Tools -> Add-ons and make sure that Zotero Word for Windows Integration is enabled. If it is disabled, enable it and restart Word. | - 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 [[#zotero_toolbar_doesn_t_appear|Zotero toolbar doesn't appear]]. | - If Zotero Word for Windows Integration is missing entirely from the Add-ons window, see [[#zotero_toolbar_doesn_t_appear|Zotero toolbar doesn't appear]]. |
| - Go into Zotero Preferences -> Cite -> Word Processors and click "Install Word for Windows Add-in". Restart Word. | - In Zotero, go to Edit → Preferences → Cite → Word Processors and click "Install Word for Windows Add-in". Restart Word. |
| |
| 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 [[/support/word_processor_plugin_manual_installation|manual installation]] | 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 [[/support/word_processor_plugin_manual_installation|manual installation]] |
| ===== Mac ===== | ===== Mac ===== |
| |
| ==== Tab does not appear in Word 2016 ==== | ==== Tab does not appear in Word 2016/2019 ==== |
| |
| First, check your [[https://support.office.com/en-us/article/about-office-what-version-of-office-am-i-using-932788b8-a3ce-44bf-bb09-e334518b8b19|specific Word version number]] and follow the appropriate steps below: | First, check your [[https://support.office.com/en-us/article/about-office-what-version-of-office-am-i-using-932788b8-a3ce-44bf-bb09-e334518b8b19|specific Word version number]] and follow the appropriate steps below: |
| 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://www.libreoffice.org/download/|LibreOffice 5.2 or later]]. | 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://www.libreoffice.org/download/|LibreOffice 5.2 or later]]. |
| |
| ==== LibreOffice 5 on macOS 10.11+: No response from plugin ==== | ==== LibreOffice on macOS 10.11+: No response from plugin ==== |
| |
| Problem: LibreOffice 5 does not currently recognize the Java Runtime Environment (JRE), and Zotero's plugin therefore doesn't work. | Problem: LibreOffice does not currently recognize the Java Runtime Environment (JRE), and Zotero's plugin therefore doesn't work. |
| |
| 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://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html|Java Development Kit (JDK) version 8]] | - Download and install the latest[[https://www.oracle.com/technetwork/java/javase/downloads/index.html|Java Development Kit (Oracle JDK)]] |
| - In LibreOffice: | - In LibreOffice: |
| - Check in Prefs -> Advanced if JDK 1.8.xx is actually selected in the box | - In Preferences -> Advanced ensure Oracle Corporation JRE is selected in the box |
| - Go to Tools -> Extension Manager, scroll down to “Zotero LibreOffice Integration", and click on it. You should see an “Enable" button appear. | - Go to Tools -> Extension Manager, scroll down to “Zotero LibreOffice Integration", and click on it. You should see an “Enable" button appear. |
| - 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 5.2.4.2 / JDK 1.8.0_112 / LO Integration Plugin 3.5.12 / Zotero 4.0.29.16 / macOS 10.12.2. | Tested successfully with LibreOffice 6.0.0.3 / JDK 1.12.0.1 / LO Integration Plugin 5.0.15 / Zotero 5.0.69 / macOS 10.14.5. |
| |
| ===== Linux ===== | ===== Linux ===== |
Upgrade Storage