Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
word_processor_plugin_troubleshooting [2019/04/02 11:56]
dstillman [Debugging broken documents]
word_processor_plugin_troubleshooting [2019/11/26 15:13] (current)
dstillman [Zotero toolbar doesn't appear]
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 "​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 outand 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]]
Line 29: Line 28:
 ===== 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 =====
  
Line 35: Line 34:
 ===== 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 ======
Line 88: Line 68:
   - 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
  
Line 102: 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 ​-> 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]]
Line 140: Line 120:
 ===== 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:
Line 307: 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://​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 ====+==== 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.+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./ 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./ JDK 1.12.0.1 / LO Integration Plugin 5.0.15 / Zotero ​5.0.69 / macOS 10.14.5.
  
 ===== Linux ===== ===== Linux =====
word_processor_plugin_troubleshooting.1554220611.txt.gz · Last modified: 2019/04/02 11:56 by dstillman