Upgrade StorageDifferences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
| debug_output [2018/04/22 15:40] – dstillman | debug_output [2019/08/01 21:12] – [Debug Output Logging] dstillman | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ===== Debug Output Logging ===== | + | ====== 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: | 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 | + | ==== Zotero ==== |
| - | - In the Help menu, go to Debug Output Logging and select Enable, or use " | + | - In the Help menu, go to Debug Output Logging and select Enable, or use " |
| - Immediately perform the relevant action (syncing, saving, importing, etc.). | - 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" | - 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) ==== | ==== Zotero Connectors (Firefox, Chrome, and Safari) ==== | ||
| Line 23: | Line 16: | ||
| - In the Advanced tab of the Zotero Connector preferences, | - In the Advanced tab of the Zotero Connector preferences, | ||
| - Immediately perform all the relevant actions (e.g., import an item from a web page). | - 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 | + | - Go back to the Advanced tab of the Zotero Connector preferences and click Submit |
| - You will be provided with a Debug ID (e.g., " | - You will be provided with a Debug ID (e.g., " | ||
| - Uncheck the box next to " | - Uncheck the box next to " | ||
| Line 29: | Line 22: | ||
| ==== Error Submitting a Debug Log ==== | ==== 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 -> " | 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' | + | ===== Logging to a Terminal Window ====== |
| + | |||
| + | If you'd like to regularly | ||
| ==== macOS ==== | ==== macOS ==== | ||
| - | |||
| - | Close Zotero and then restart it via the command line: | ||
| * Open Terminal via Spotlight or / | * Open Terminal via Spotlight or / | ||
| - | + | | |
| - | | + | |
| * Press Return | * 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 ==== | ==== Windows ==== | ||
| - | Close Zotero, and then restart it via the command line: | + | Start Zotero via the Cygwin terminal (not cmd.exe): |
| - | * Press Windows + R or search for 'run' | + | * Open the Cygwin terminal |
| - | * Select the appropriate file and click Open. | + | * Paste '' |
| - | * In the Run box, append %%" | + | * Press Enter. |
| - | * 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 ==== | ==== Linux ==== | ||
| - | Close Zotero, and then restart it via the command line, adding the -ZoteroDebug command-line flag. | + | Start Zotero 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 === | === Developer Note === | ||
| To enable Zotero debug output permanently, | To enable Zotero debug output permanently, | ||