no way to compare when less than two revisions
Differences
This shows you the differences between two versions of the page.
Previous revisionLast revision | |||
— | ja:word_processor_plugin_troubleshooting [2017/11/12 19:53] – external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | < | ||
+ | in the process of updating the documentation for | ||
+ | <a href=" | ||
+ | may be outdated in the meantime. Thanks for your understanding.</ | ||
+ | |||
+ | This page describes some of the reported issues with the [[word_processor_integration|Zotero word processor plugins]], together with possible solutions. | ||
+ | |||
+ | ====== All Plugins/ | ||
+ | |||
+ | ===== Formatting Issues ===== | ||
+ | Citations and bibliographies generated by the word processor plugins might appear in a different style (font, font-size, etc) than the surrounding text. The appearance of the generated text can be changed by changing the default style. E.g. in OpenOffice, open the styles manager in ' | ||
+ | |||
+ | Bibliography formatting is controlled in the style file, and should conform to the requirements of the style in use. In the 3.0 series plugins for Zotero 2.0.x, line and entry spacing will be overwritten on each document update. In the 3.1 series plugins for Zotero 2.1, the formatting of the bibliography can be modified by editing the " | ||
+ | |||
+ | ===== Incompatible plugin ===== | ||
+ | |||
+ | The Zotero word processor plugin will only work if you install the correct version. (Note that Zotero 2.0 uses a different plugin from Zotero 1.0.x, and Zotero 2.1 uses a different plugin from Zotero 2.0, so after upgrading Zotero you will also need to upgrade your plugin.) If you try to use an incompatible version of the plugin, you will receive an error message similar to: | ||
+ | |||
+ | //" | ||
+ | |||
+ | To solve this problem, install the [[word_processor_plugin_installation|correct version of the plugin]]. | ||
+ | |||
+ | If the problems persists after using the installer, remove the old version manually. For Windows Word and Word 2004 for Mac, remove the plugin file " | ||
+ | |||
+ | ===== Zotero toolbar doesn' | ||
+ | |||
+ | If the Zotero toolbar (or [[kb: | ||
+ | |||
+ | - Close Word or OpenOffice. | ||
+ | - In Firefox, go to Tools→Add-ons→Extensions. (If you don't see " | ||
+ | - Click the " | ||
+ | - Click “Reinstall Word Components” or " | ||
+ | |||
+ | In Word for Windows and Word 2004 for Mac, make sure that the Zotero toolbar is enabled in View-> | ||
+ | |||
+ | Additional steps may be required for [[# | ||
+ | |||
+ | ===== 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: | ||
+ | |||
+ | - Make sure the Track Changes feature in Word/ | ||
+ | - You cannot have 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. | ||
+ | - If you are using Word, or if you are using bookmarks in OpenOffice.org, | ||
+ | - 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 if " | ||
+ | - 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@zot....org so we can take a look at it. For all other discussion, please post to the forums. | ||
+ | - While debugging, if you are using Fields mode in Word or Reference Marks mode in OpenOffice, it may help to display field codes rather than formatted text. To do this in Word, press Alt-F9 on Windows or Option-F9 on OS X. In OpenOffice, press Control-F9. | ||
+ | |||
+ | ====== Word ====== | ||
+ | |||
+ | ===== Windows ===== | ||
+ | |||
+ | ==== Communication error or non-responsive plugin buttons==== | ||
+ | |||
+ | //" | ||
+ | Or plugin appears and buttons are clickable, but no insert citation window appears. | ||
+ | |||
+ | - If you use ZoneAlarm, disable ForceField, which is known to cause a [[http:// | ||
+ | - Windows plugins communicate with Firefox using the remote window. Thus, launching Firefox with the -no-remote command-line option will prevent the plugins from functioning. (You might do this if you have [[http:// | ||
+ | |||
+ | ==== Toolbar does not appear in Word for Windows or is incompatible ==== | ||
+ | |||
+ | After installing the [[word_processor_plugin_installation|latest Word plugin for Zotero]] on a system with a non-English version of Office, the toolbar may not appear in Word. Alternatively, | ||
+ | |||
+ | These problems indicate that the new template was not installed into the correct location for your installation. By default, Zotero installs the template into your Word Startup directory. You may need to [[windows_word_plugin_manual_installation_instructions|manually install the Zotero.dot file]] into the correct directory. | ||
+ | |||
+ | ==== "Could not find a running Word instance" | ||
+ | |||
+ | If you install Zotero with Word 2010 and receive an error stating | ||
+ | |||
+ | //" | ||
+ | |||
+ | you may be experiencing an issue relating to your Word 2010 installation method. Microsoft distributes a set of " | ||
+ | |||
+ | You can fix this problem by switching your copy of Office 2010 from a Click-to-Run installation to a standard (MSI-based) installation. This process does not require an additional license. To do so, follow the steps under the " | ||
+ | |||
+ | ===== Mac ===== | ||
+ | |||
+ | ==== Component loading error ==== | ||
+ | |||
+ | Under some circumstances, | ||
+ | |||
+ | //" | ||
+ | |||
+ | You may also repeatedly see the following message upon starting Firefox: | ||
+ | |||
+ | //"The Zotero MacWord Integration installation succeeded, but a necessary component does not appear to be loaded properly."// | ||
+ | |||
+ | These errors are caused by an issue with [[http:// | ||
+ | |||
+ | - Open Tools-> | ||
+ | - Click the " | ||
+ | - Restart Firefox. You should get an error message stating that PythonExt is corrupted or incompletely deleted. Press OK to completely delete it. | ||
+ | - Firefox will restart again. You will see an error message stating that Zotero MacWord Integration requires PythonExt. Ignore it. | ||
+ | - Download the updated version of PythonExt from the [[word_processor_plugin_installation|installation page]]. | ||
+ | |||
+ | At this point, we believe that we've traced the causes of all PythonExt issues. If you are up-to-date and are still experiencing the above issues, you should post with a [[reporting_problems|Report ID]] on the [[http:// | ||
+ | |||
+ | ==== No response from plugin ==== | ||
+ | |||
+ | If you getting no response when you attempt to use the Word plugin, try the following steps: | ||
+ | |||
+ | - Restart Word and try again. | ||
+ | - Close Word and go to Tools-> | ||
+ | |||
+ | ==== Toolbar does not appear in Word 2004 or is incompatible ==== | ||
+ | |||
+ | After installing the [[word_processor_plugin_installation|latest Word plugin for Zotero]] on a system with a non-English version of Office 2004 for Mac installed or with a non-administrator OS X user account, the toolbar may not appear in Word. Alternatively, | ||
+ | |||
+ | These problems indicate that the new template was not installed into the correct location for your installation. By default, Zotero installs the template into / | ||
+ | |||
+ | **If you have a non-English version of Office**, you may need to move the Zotero.dot file into the " | ||
+ | |||
+ | **If you're using a non-admin OS X user account**, you will need to install the Word plugin from an administrative account or grant write access for the startup directory to the non-admin account to allow it to install Zotero.dot. | ||
+ | |||
+ | To grant write access, navigate to / | ||
+ | |||
+ | ==== Scripts do not appear in Word 2008/2011 or are incompatible ==== | ||
+ | |||
+ | After installing the [[word_processor_plugin_installation|latest Word plugin for Zotero]] on a system with a non-English version of Office 2008/2011 for Mac installed, the [[kb: | ||
+ | |||
+ | These problems indicate that the new scripts were not installed into the correct location. By default, Zotero installs the scripts into ~/ | ||
+ | |||
+ | - If you have only non-English versions of Office installed, you can delete the Microsoft User Data folder if it contains nothing other than the Zotero scripts. You can then re-install the Zotero scripts by going to Tools-> | ||
+ | - If you have both English and non-English versions of Office installed, you should copy the Zotero folder from ~/ | ||
+ | |||
+ | ==== Document update error in Word 2011 ==== | ||
+ | |||
+ | Some Word 2011 users may see the following message upon attempting to insert a citation or bibliography into a new or existing Word document: | ||
+ | |||
+ | //" | ||
+ | \\ | ||
+ | COMMAND: app(u'/ | ||
+ | |||
+ | This error may appear if a custom installation of Office 2011 is performed, and " | ||
+ | |||
+ | There may also be a bug in Word itself that may cause this message to appear for some users even if Visual Basic for Applications is installed. See [[http:// | ||
+ | |||
+ | Note that " | ||
+ | |||
+ | ==== Communication error ==== | ||
+ | |||
+ | //" | ||
+ | |||
+ | You might experience this error if you have recently upgraded Zotero MacWord Integration and are running Microsoft Word 2008/2011 for Mac on a non-English language system. Close Word and then, in Firefox, go to Tools→Add-ons→Extensions. Click the “Preferences” button next to “Zotero MacWord Integration” and then click “Reinstall Word Components.” | ||
+ | |||
+ | ===== Linux ===== | ||
+ | |||
+ | The Zotero Word for Windows plugin does not work out of the box under WINE, CrossOver Office, or other compatibility environments for Linux. We do not support running the Word for Windows plugin under Linux, and advise users to use LibreOffice/ | ||
+ | |||
+ | ====== OpenOffice.org, | ||
+ | |||
+ | ===== All Platforms ===== | ||
+ | |||
+ | ==== Installation error ==== | ||
+ | |||
+ | At the last step of OpenOffice.org Integration installation, | ||
+ | |||
+ | //"An error occurred installing Zotero OpenOffice.org/ | ||
+ | |||
+ | If you experience this error during plugin installation, | ||
+ | The displayed comment may be: | ||
+ | |||
+ | “The Zotero OpenOffice.org/ | ||
+ | |||
+ | and will also have a button to **Install Extension**. | ||
+ | |||
+ | Click the button which displays an **Integration Installation** dialog. | ||
+ | When you are asked to locate your OpenOffice.org/ | ||
+ | |||
+ | ==== NullPointerException or lastDataListener is undefined error ==== | ||
+ | |||
+ | In Zotero OpenOffice.org Integration 3.5a2, when attempting to add or edit a citation or bibliography, | ||
+ | |||
+ | // | ||
+ | at | ||
+ | org.zotero.integration.ooo.comp.Comm.getMessageResponse// | ||
+ | |||
+ | or the message | ||
+ | |||
+ | // | ||
+ | |||
+ | This error indicates that the version of the extension installed within Firefox does not match the version of the extension installed within OpenOffice.org, | ||
+ | |||
+ | Users with other word processor integration plugins (Word for Mac or Word for Windows) installed should also make sure that those plugins are the latest available versions. | ||
+ | |||
+ | ==== Troubleshooting previous versions ==== | ||
+ | |||
+ | The latest series of Zotero OpenOffice.org Integration releases is the [[word_processor_plugin_installation_for_zotero_2.1# | ||
+ | |||
+ | ===== Windows ===== | ||
+ | |||
+ | ==== Could not create java implementation loader ==== | ||
+ | |||
+ | Upon manual installation of the OpenOffice.org/ | ||
+ | |||
+ | //" | ||
+ | |||
+ | This error reflects a faulty Java installation within OpenOffice.org or LibreOffice. This issue affects not only Zotero, but any OpenOffice.org/ | ||
+ | |||
+ | First, check that Java is installed and enabled in OpenOffice.org or LibreOffice by choosing Tools→Options→OpenOffice.org→Java. Ensure that "Use a Java runtime environment" | ||
+ | |||
+ | If Java is installed and enabled but the error persists, one possible solution involves removing the Zotero OpenOffice.org Integration component from Tools→Extension Manager within OpenOffice.org or LibreOffice, | ||
+ | |||
+ | Alternatively, | ||
+ | |||
+ | ===== Mac ===== | ||
+ | |||
+ | ==== Could not create java implementation loader ==== | ||
+ | |||
+ | Upon manual installation of the OpenOffice.org/ | ||
+ | |||
+ | //" | ||
+ | |||
+ | This is usually caused by an outdated version of OpenOffice, LibreOffice, | ||
+ | |||
+ | ===== Linux ===== | ||
+ | |||
+ | ==== Installation error, or clicking toolbar buttons does not have an effect (LibreOffice)==== | ||
+ | On some Linux installations the Zotero toolbar refuses to install properly in LibreOffice, | ||
+ | |||
+ | Installing the libreoffice-java-common package, available in the repositories of most common linux distributions, | ||
+ | |||
+ | You may still need to activate the extension: In LibreOffice go to Tools -> Extension Manager | ||
+ | Select " | ||
+ | |||
+ | === Can't insert Citations in Libre Office under Kubuntu === | ||
+ | This is due to a bug in Libre Office in KDE - uninstalling libreoffice-kde fixes this. See [[http:// |