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/10/31 01:52] – [Citations/bibliography highlighted] 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 Zotero preferences, open the "Word Processors" tab. |
- Click “Reinstall LibreOffice/Microsoft Word Add-in” and then restart your word processor. | - Click “Reinstall LibreOffice/Microsoft Word Add-in” and then restart your word processor. |
===== 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 ===== |
- 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 |
| |
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 ===== |