Differences
This shows you the differences between two versions of the page.
Previous revisionNext revision | |||
— | debug_output [2018/04/22 15:40] – dstillman | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ===== Debug Output Logging ===== | ||
+ | If you've been asked to provide a Debug ID (which is different from a [[reporting problems|Report ID]]) to help troubleshoot a problem, follow these simple steps: | ||
+ | |||
+ | ==== Zotero 5 and later ==== | ||
+ | |||
+ | - In the Help menu, go to Debug Output Logging and select Enable, or use " | ||
+ | - Immediately perform the relevant action (syncing, saving, importing, etc.). | ||
+ | - Before doing anything else, return to Help -> Debug Output Logging and click Submit Output, which will disable logging and submit the output to zotero.org. A window should pop up containing a Debug ID (e.g., “D12345678”). Click "Copy to Clipboard" | ||
+ | |||
+ | ==== Zotero 4 for Firefox ==== | ||
+ | - Open the Advanced pane of the Zotero [[preferences|preferences]]. You can access the Zotero preferences from the gear {{: | ||
+ | - Click " | ||
+ | - Immediately perform the relevant action (syncing, saving, importing, etc.). | ||
+ | - Before doing anything else, click " | ||
+ | - Disable debug output logging and click "Clear Output" | ||
+ | |||
+ | ==== Zotero Connectors (Firefox, Chrome, and Safari) ==== | ||
+ | - Open the Zotero Connector preferences | ||
+ | * **Firefox: | ||
+ | * **Chrome:** type %%chrome:// | ||
+ | * **Safari:** right-click anywhere on a webpage and select " | ||
+ | - In the Advanced tab of the Zotero Connector preferences, | ||
+ | - Immediately perform all the relevant actions (e.g., import an item from a web page). | ||
+ | - Go back to the Advanced tab of the Zotero Connector preferences and click Submit to Zotero Server. | ||
+ | - You will be provided with a Debug ID (e.g., " | ||
+ | - Uncheck the box next to " | ||
+ | |||
+ | |||
+ | ==== Error Submitting a Debug Log ==== | ||
+ | |||
+ | === Zotero 5.0.8 and later === | ||
+ | |||
+ | If submitting output fails, you can return to the Debug Output Logging menu and select View Output, go to File -> " | ||
+ | ===== Real-time Debug Output ====== | ||
+ | |||
+ | If you'd like to follow Zotero' | ||
+ | |||
+ | ==== macOS ==== | ||
+ | |||
+ | Close Zotero and then restart it via the command line: | ||
+ | |||
+ | * Open Terminal via Spotlight or / | ||
+ | |||
+ | * Paste %%" | ||
+ | |||
+ | * Press Return | ||
+ | |||
+ | Zotero should start up with a separate window that shows debug output and allows you to easily submit the output and create a Debug ID for posting to the forums. | ||
+ | |||
+ | To capture output for a particular action (e.g., for a translator save attempt), press Clear before performing the action and then submit the output immediately afterwards. | ||
+ | |||
+ | If for some reason the debug window doesn' | ||
+ | |||
+ | If you receive the message **" | ||
+ | |||
+ | ==== Windows ==== | ||
+ | |||
+ | Close Zotero, and then restart it via the command line: | ||
+ | |||
+ | * Press Windows + R or search for ' | ||
+ | * Select the appropriate file and click Open. | ||
+ | * In the Run box, append %%"%% -ZoteroDebug%%" | ||
+ | * Click OK. | ||
+ | |||
+ | Zotero should start up with a separate window that shows debug output and allows you to easily submit the output and create a Debug ID for posting to the forums. | ||
+ | |||
+ | To capture output for a particular action (e.g., for a translator save attempt), press Clear before performing the action and then submit the output immediately afterwards. | ||
+ | |||
+ | If you cannot locate Zotero, find an existing shortcut to it (e.g., on your desktop or in the Start menu), right-click it, select Properties, make sure the Target field is selected, and copy it to the clipboard by pressing Ctrl-C. Click Cancel to close the shortcut window. Back in the Run window, clear the field and paste in the clipboard by pressing Ctrl-V. At the end of the field, after the second quotation marks, add a space followed by ' | ||
+ | |||
+ | ==== Linux ==== | ||
+ | |||
+ | Close Zotero, and then restart it via the command line, adding the -ZoteroDebug command-line flag. | ||
+ | |||
+ | Zotero should start up with a separate window that shows debug output and allows you to easily submit the output and create a Debug ID for posting to the forums. | ||
+ | |||
+ | To capture output for a particular action (e.g., for a translator save attempt), press Clear before performing the action and then submit the output immediately afterwards. | ||
+ | |||
+ | If for some reason the debug window doesn' | ||
+ | |||
+ | === Developer Note === | ||
+ | |||
+ | To enable Zotero debug output permanently, |