Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
word_processor_plugin_troubleshooting [2020/05/27 17:57] – [Mac] dstillman | word_processor_plugin_troubleshooting [2020/08/15 11:38] – [Mac] dstillman |
---|
- Close Word or LibreOffice. | - Close Word or LibreOffice. |
- In the Cite pane of the [[preferences|Zotero preferences]], open the Word Processors tab, click “Install Microsoft Word Add-in” or “Install LibreOffice Add-in”, and then restart your word processor. | - In the Cite pane of the [[preferences|Zotero preferences]], open the Word Processors tab, click “Install Microsoft Word Add-in” or “Install LibreOffice Add-in”, and then restart your word processor. |
- If you don't see the installation buttons described in Step 2, go to Tools → Add-ons in Zotero. | * If you don't see the installation buttons in the Cite pane, you'll need to repair your Zotero installation: |
- 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. | - Go to Tools → Add-ons in Zotero. |
- If the "Enable" button is grayed out and you are unable to click it, click the "Remove" button and restart Zotero. | - 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 you don't see the integration plugins in Add-ons 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 the "Enable" button is grayed out and you are unable to click it, click the "Remove" button and restart Zotero. |
- If you still don't see the installation buttons in the Cite → Word Processors pane of the Zotero preferences, it may help to open your [[kb:profile_directory|Zotero profile directory]], delete extensions.json, and restart Zotero. If you've installed any third-party plugins, you may need to reinstall them. | - If you don't see the integration plugins in Add-ons 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 still don't see the installation buttons in the Cite → Word Processors pane of the Zotero preferences, it may help to open your [[kb:profile_directory|Zotero profile directory]], delete extensions.json, and restart Zotero. If you've installed any third-party plugins, you may need to reinstall them. |
- If the Zotero tab or toolbar still doesn't appear in your word processor after clicking the reinstall button in the Zotero preferences and restarting your word processor, follow the [[word_processor_plugin_manual_installation|manual installation instructions]]. | - If the Zotero tab or toolbar still doesn't appear in your word processor after clicking the reinstall button in the Zotero preferences and restarting your word processor, follow the [[word_processor_plugin_manual_installation|manual installation instructions]]. |
| |
| |
* Check that LibreOffice is up to date, as new Java releases sometimes introduce incompatibilities with LibreOffice. | * Check that LibreOffice is up to date, as new Java releases sometimes introduce incompatibilities with LibreOffice. |
* Open the LibreOffice options dialog by choosing Tools → Options (Windows/Linux) or LibreOffice → Preferences… (Mac). In the dialog, click LibreOffice → Java (or Advanced). Ensure that "Use a Java runtime environment" is checked, and that a JRE is selected in the list below. (It may take a few seconds to load.) If no JRE appears in the list, [[http://www.oracle.com/technetwork/java/javase/downloads/index.html|install a Java JRE]]. Make sure that LibreOffice and JRE platforms (32-bit/64-bit) match. | * Open the LibreOffice options dialog by choosing Tools → Options (Windows/Linux) or LibreOffice → Preferences… (Mac). In the dialog, click LibreOffice → Java (or Advanced). Ensure that "Use a Java runtime environment" is checked, and that a JRE is selected in the list below. (It may take a few seconds to load.) If no JRE appears in the list, [[https://www.java.com/inc/BrowserRedirect1.jsp?locale=en|install a Java JRE]]. Make sure that LibreOffice and JRE platforms (32-bit/64-bit) match. |
| |
Next, restart Zotero, open the Cite pane of the [[preferences|Zotero preferences]], and click the **Install LibreOffice Add-in** button on the "Word Processors" tab. | Next, restart Zotero, open the Cite pane of the [[preferences|Zotero preferences]], and click the **Install LibreOffice Add-in** button on the "Word Processors" tab. |
| |
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 on macOS 10.11+: No response from plugin ==== | |
| |
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. | |
| |
- Uninstall the JRE | |
- Download and install the latest[[https://www.oracle.com/technetwork/java/javase/downloads/index.html|Java Development Kit (Oracle JDK)]] | |
- In LibreOffice: | |
- 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. | |
- After enabling, the Zotero buttons in the LibreOffice toolbar should be responsive. | |
| |
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 ===== |
| |