COMMANDS.md

Item menu functions

Each of the functions below can be called from the Zotero item context menu (accessed by right-clicking in the items pane in the middle of Zotero where all of a collection's items are listed). In the Zutilo preferences (accessed from the same menu as Zotero's preferences), each of these functions can be set to show up in the Zotero item menu, in a Zutilo submenu of the Zotero item menu, or not to appear at all.

• Copy tags: Right click items in the Zotero library and copy their tags to the clipboard as a '\r\n' delimited list. Such a list of tags can be pasted into a new tag box to add all of the tags to an item at once.

• Remove tags: Right click items in the Zotero library and remove all of their tags.

• Paste tags: Right click items in the Zotero library and paste the contents of the clipboard to them. The contents of the clipboard must be a '\r\n' or '\n' delimited list (such as the list created by the copy tags function described above).

• Copy creators: Right click items in the Zotero library and copy their creators to the clipboard as a '\r\n' delimited list.

• View attachment paths: Display the paths to selected attachment items and to attachments of selected regular items (one by one as separate dialog windows -- you probably don't want to select more than a couple items at a time this way!).

• Modify attachment paths: Change the beginning of the path to all eligible selected attachments and to all attachments of selected regular items. Two prompt windows appear. The first asks for the old partial path while the second asks for the new partial path. If you enter "C:/userData/references/" for the first path and "E:/" for the second path, then an attachment file with a path of "C:/userData/references/journals/Nature/2008/coolPaper.pdf" will have its path changed to "E:/journals/Nature/2008/coolPaper.pdf" while an attachment with path "E:/journals/Science/2010/neatPaper.pdf" will be left unchanged. This function is mainly useful for when you change computers or hard drives and break the links to all of your attachments (though note that Zotero has a relative attachment path feature that should address this issue for attachment collections all stored togehter under one parent directory).

  By default, the old partial path is only compared with the beginning of each attachment path. To replace elements of attachment paths not at the beginning, click the "replace all instances" check box in the first prompt window. This option is useful if you want to rename a subfolder or switch between Windows and Unix style paths (replacing \ and /).

• Modify attached URLs: This function works the same as Modify attachment paths above but modifies the URL of URL attachments instead of the file path of linked file attachments.

• Copy attachment paths: Copy to the clipboard the path for each selected attachment and/or each child attachment of each selected item. For file attachments, the full path on the file system is copied. URL link attachments are ignored.

• Relate items: Set all selected items to be related to each other.

• QuickCopy items: Copy selected items to the clipboard using the "Default output format" specified in the "Export" section of Zotero's preferences. There are also two alternative QuickCopy items (labeled "alt 1" and "alt 2"). These items will copy to the clipboard using alternative export translators. To select the translators used by these functions, the corresponding preferences extensions.zutilo.quickcopy_alt1 and extensions.zutilo.quickcopy_alt2 must be set in the config editor. Each preference should be set to whatever appears in the config editor for the export.quickCopy.setting preference when the desired translator is set as the "Default output format" in Zotero's preferences. The config editor can be opened from the Advanced pane of Zotero's preferences window (or by visiting about:config if using Zotero as a Firefox add-on).

• Copy select item links: Copy links of the form "zotero://select/items/ITEM_ID" to the clipboard for each selected item. Pasting such a link into the Firefox address bar will select the corresponding item in the Zotero Firefox plugin. Following links from other applications and having the links select items in the Zotero Standalone client may also be achievable but might require additional set up.

• Copy Zotero URIs: Copy (www.zotero.org) links to the clipboard for each selected item. If you have a (www.zotero.org) profile, following such a link will open the page for the corresponding item in profile on (www.zotero.org). If you do not have a (www.zotero.org) profile, a placeholder link is still generated but might not be useful.

• Create book section: Create a book section item from the currently selected book item.

  The new item is created by duplicating the book item and changing its type to book section. Author entries for the book item are converted to "book author" entries for the new book section item. The new book section item is added as a related item to the original book item. Finally, the title textbox for the new item is focused so that a new title for the book section may be entered.

  This function only works when a single book item is selected. Note that some fields (number of pages and short title, as of late 2014) apply only to book items and not book section items. There is no prompt to confirm this loss of fields from the created book section item.

• Create book item: Create a book item from teh currently selected book section item.

  First the book section item is duplicated and converted to a book item. Then the item's title is set to the "Book title" of the book section item and its abstract is deleted. The new book item is set as a related item of the book section item. Finally the title field of the new book item is selected for editing.

• Copy child items: Copy the child items of a selected item to an internal Zutilo clipboard (not the desktop clipboard). This function is meant to be used in conjunction with the "Relocate child items" function.

• Relocate child items: Move all items stored in Zutilo's internal clipboard (put there by the "Copy child items" function) to the currently selected item.

• Copy item fields: Copies all source-item metadata fields to the clipboard. The data copied is all data visible in the right panel only (not tags, not notes).

• Paste into empty item fields: (‘Paste-into-empty’) paste where source has value and target has none/empty. Authors from the source are merged in even if the target already has authors.

• Paste non-empty item fields (‘Paste-non-empty’): paste where source has value. Replaces authors if there is an author field in the pasted data.

• Paste all items fields (Paste-all): paste all fields from source, even if they are empty.

Collection menu functions

Each of the functions below can be called from the Zotero collection context menu (accessed by right-clicking on a collection in the collections pane at the right of Zotero where all the collections are listed). In the Zutilo preferences (accessed from the same menu as Zotero's preferences), each of these functions can be set to show up in the Zotero item menu, in a Zutilo submenu of the Zotero item menu, or not to appear at all.

• Copy select collection links: Copy links of the form "zotero://select/groups/LIBRARY_ID/collections/COLLECTION_ID" to the clipboard for each selected item. Pasting such a link into the Firefox address bar will select the corresponding item in the Zotero Firefox plugin. Following links from other applications and having the links select items in the Zotero Standalone client may also be achievable but might require additional set up.

• Copy Zotero URIs: Copy (www.zotero.org) links to the clipboard for the selected collection. If you have a (www.zotero.org) profile, following such a link will open the page for the corresponding item in profile on (www.zotero.org). If you do not have a (www.zotero.org) profile, a placeholder link may be generated but might not be useful.

Navigating the UI and editing items via keyboard shortcuts

Zutilo currently implements several keyboard shortcuts that are useful for editing Zotero items. The following functions work when only a single Zotero item is selected:

• Edit item info: Select the "Info" tab in the item pane. Set the focus to the first editable field of the item's info.

• Add note: Select the "Notes" tab of the item pane. Create a new note. Added for completeness, but Zotero already has a keyboard shortcut that does this. It can be set in Zotero's preferences.

• Add tag: Select the "Tags" tab of the item pane. Open a textbox for creating a new tag.

• Add related item: Select the "Related" tab of the item pane. Open the dialog for adding related items.

The following four functions are similar to the four item editing functions above, except that they just set focus on the respective tab in the item pane.

• Focus item pane: Info tab: Select the "Info" tab in the item pane.

• Focus item pane: Notes tab: Select the "Notes" tab of the item pane.

• Focus item pane: Tags tab: Select the "Tags" tab of the item pane.

• Focus item pane: Related tab: Select the "Related" tab of the item pane.

The following two functions allow you to cycle through the same four tags in the item pane.

• Focus item pane: next tab: Select next tab in item pane.

• Focus item pane: previous tab: Select previous tab in item pane.

Zutilo implements several keyboard shortcuts that are useful for navigating between and within the three main panes. If the relevant pane is hidden, the following functions will show it.

• Focus collections pane: Set the focus to the collections pane (left pane, Libraries pane). Similar to the existing Zotero shortcut, except that this function also shows the pane if it's hidden.

• Focus items pane: Set the focus to the items pane (middle pane).

The following two functions allow you to easily show or hide the collections pane (left pane) and the item pane (right pane).

• Item pane: Show / hide: Show or hide the item pane.

• Collections pane: Show / hide: Show or hide the collections pane.

Like the functions above, the following two functions allow you to easily show or hide the collections pane (left pane) and the item pane (right pane). However, when the pane is shown, the thicker vertical divider ("splitter", "grippy", appears when the pane is hidden) remains visible until the width of the pane is adjusted.

• Item pane: Show / hide (sticky): Show or hide the item pane. When the pane is show, the thicker vertical divider remains visible until the width of the pane is adjusted.

• Collections pane: Show / hide (sticky): Show or hide the collections pane. When the pane is show, the thicker vertical divider remains visible until the width of the pane is adjusted.

Attachment functions

• Attach link to file: Open a file picker dialog for selecting a file to attach to the currently selected item as a linked file attachment.

• Attach uri: Open a textbox dialog for adding a URI attachment to the current item.

• Attach stored copy: Open a file picker dialog for selecting a file to attach to the currently selected item as a stored attachment.

• Create parent item: Create a parent item for the currently selected attachment item that does not have a parent.

• Rename attachments: Use the parent item's metadata to rename its attachments.

• Retrieve metadata for pdf: Try to look up the metadata for the selected stored pdf attachment in Google Scholar.

Miscellaneous functions

• Duplicate item: Create a duplicate of the selected item

• Generate report: Generate Zotero report from selected items or collection. If the Collections pane has focus, a report is generated for the selected collection. Otherwise, a report is generated for the currently selected items.

• Open New Item menu: Open the new item menu so that the type of new item to create can be selected from it.

• Open style editor: Open the style editor window (normally accessible from the advanced section of Zotero's preferences).

Firefox browser shortcut functions

The following shortcut functions are only available in the Zotero Firefox addon.

• Focus Zotero: Make Zotero visible if it is not. Focus Zotero so that, e.g., Tab and the arrow keys work on the Zotero UI rather than the previously focused element of Firefox's UI.

• Hide Zotero: Hide Zotero if it was visible.

• Toggle Zotero: Show Zotero if it was not visible. Otherwise hide Zotero.

• Save webpage as a Zotero item: Save the current page as a webpage item in Zotero.

• Save item: Add an item to the Zotero library based on the reference content of the current webpage (equivalent to clicking on the little page/book icon in the Firefox address bar). In Zotero, the function that creates the item from the web page content is referred to as a translator.

• Save item without attachments: Create an item in a similar manner to "Save item" but do not save attachment files for the item regardless of whether or not Zotero is set to save such attachments in its preferences.

• Save item with attachments: Create an item in a similar manner to "Save item" but do save attachment files for the item regardless of whether or not Zotero is set to save such attachments in its preferences.

• Save item (reverse attachment pref): Create an item in a similar manner to "Save item" but only save attachments if Zotero is set not to save attachments in its preferences.

• Attach current page: Attach the current browser page to the selected Zotero item. This function works best when the current web page is a PDF opened with Firefox's internal PDF viewer.

Firefox browser menu functions

These functions add items to the Zotero "Save item" button's menu and to the Firefox right-click menu. Any of the menu items can be set to hidden in Zutilo's preferences.

• Attaching webpages and links to Zotero items: Zutilo adds context menu items to Firefox for attaching the current page or the current link target (if a link is selected in the current web page) to the item currently selected in Zotero. Attaching the current web page is also available as a keyboard shortcut.

  How the attachment is processed depends on the attachment method set in Zutilo's preferences. If the method is 'Import', an imported attachment is created from the page/link. If the method is 'Prompt for linked file', a file prompt appears to allow the user to specify a new file. The page/link is saved to this file and then a linked file attachment (linked to the downloaded file) is created. If the method is 'Prompt after first', an imported attachment is created if the selected item has no previous attachments (not counting webpage snapshot attachments). Otherwise, the file prompt for creating a linked file attachment is shown. If the shift key is pressed when the attachment function is activated, a prompt for a linked file is shown regardless of Zutilo's preference setting. If the control key is pressed, the attachment is imported regardless of Zutilo's preference setting.

• Save item from a current webpage with or without attachments: Zutilo adds extra menu items to the context menu of Zotero's "Save item" button that save an item for the current page with or without extracting the page's associated PDF's and other files. That is, if the "Automatically attach PDFs and other files" preference is selected in Zotero, Zutilo adds menu items for saving the item without attachments. One menu item is created for each "Save to Zotero" method that applies to the current page. If the preference is not selected, Zutilo adds menu items for saving an item with the attachments.

  This function works by toggling the associated files preference in Zotero, creating the item, and then toggling the preference back to its original state. Because Zotero translates pages asynchronously (and thus simultaneously), translations made with this function should be allowed to finish before starting normal page translations with Zotero (since otherwise the state of the "Associated files" preference will depend on the timing of the simultaneous translations).

Better BibTeX functions

The following functions are only available when Better BibTeX is installed (and only for Zotero version 5.0 or higher).

• Pin key: Pin the key for the currently selected items.

• Unpin key: Unpin the key for the currently selected items.

• Force-refresh key: Force-refresh the key for the currently selected items.