Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
libreoffice_writer_plugin_usage [2017/12/01 11:33] – [Customizing Cites] bwierniklibreoffice_writer_plugin_usage [2022/11/02 04:34] (current) – [Keyboard Commands] dstillman
Line 1: Line 1:
 ====== Using the Zotero LibreOffice Plugin ====== ====== Using the Zotero LibreOffice Plugin ======
  
 +These are instructions for using the Zotero LibreOffice Plugin. For plugins for Word or Google Docs, see [[word_processor_integration|Word Processor Plugins]].
 ===== Zotero Plugin Toolbar ===== ===== Zotero Plugin Toolbar =====
  
 {{ :word_integration:zotero-toolbar-libreoffice-5.png?200&nocache&nolink}} {{ :word_integration:zotero-toolbar-libreoffice-5.png?200&nocache&nolink}}
  
-[[/support/word_processor_plugin_installation|Installing]] the Zotero LibreOffice plugin adds a Zotero toolbar to LibreOffice.+[[/support/word_processor_plugin_installation|Installing the Zotero LibreOffice plugin]] adds a Zotero toolbar to LibreOffice.
  
 The Zotero toolbar contains these icons: The Zotero toolbar contains these icons:
Line 39: Line 40:
 Clicking the “Add/Edit Bibliography” ({{:word_integration:zotero-toolbar-word-add-edit-bibliography-5.png?16&nocache&nolink}}) button inserts a bibliography at the cursor location. Clicking the “Add/Edit Bibliography” ({{:word_integration:zotero-toolbar-word-add-edit-bibliography-5.png?16&nocache&nolink}}) button inserts a bibliography at the cursor location.
  
-You can edit which items appear in the bibliography by clicking the “Add/Edit Bibliography” button again, which will open the bibliography editor.+You can edit which items appear in the bibliography by clicking the “Add/Edit Bibliography” button again, which will open the bibliography editor. See [[#editing_the_bibliography|below]]. Manual edits made to the bibliography in LibreOffice will be overwritten the next time Zotero refreshes the document.
  
 =====Document Preferences===== =====Document Preferences=====
Line 60: Line 61:
 =====Customizing Cites===== =====Customizing Cites=====
  
-Cites can be customized in various ways. To start, click the shaded cite in the Add Citation box to open the cite options window.+Citations can be customized in various ways. 
 + 
 +If a citation is simply incorrect or missing data, start by making sure that the item metadata in Zotero is correct and completeand then click Refresh in the plugin to update your document with any changes. 
 + 
 +Other customizations can be made via the citation dialog. Click an existing citation in your document and click Add/Edit Citation to open the citation dialog, and then click the citation bubble to open the cite options window, where you can make the following changes.
  
 ==Page and Other Locators== ==Page and Other Locators==
Line 69: Line 74:
  
 The cite options windows has a drop-down list of the different locator types ("Page" is the default), and a text box in which you can enter the locator value (e.g. "4-7"). To cite a locator other than the ones listed (e.g., "Table), use the Suffix field. The cite options windows has a drop-down list of the different locator types ("Page" is the default), and a text box in which you can enter the locator value (e.g. "4-7"). To cite a locator other than the ones listed (e.g., "Table), use the Suffix field.
 +
 +You can also add page numbers from the keyboard as you insert citations. Search for an item, press Enter once to add to the citing dialog, and then, before pressing Enter again to insert it into the document, simply type "p.34" or similar, and the page number will be added to the citation.
  
 ==Prefix and Suffix== ==Prefix and Suffix==
Line 78: Line 85:
 Prefixes and suffixes can be applied to each item in a citation to create complex citations. For example: "(see Smith 1776 for the classic example; Marx 1867 presents and alternate view)". Modifying citations by entering text into the Prefix and Suffix fields is always preferable to directly typing in the citation fields in LibreOffice. Manual modifications will prevent Zotero from automatically updating the citation. Prefixes and suffixes can be applied to each item in a citation to create complex citations. For example: "(see Smith 1776 for the classic example; Marx 1867 presents and alternate view)". Modifying citations by entering text into the Prefix and Suffix fields is always preferable to directly typing in the citation fields in LibreOffice. Manual modifications will prevent Zotero from automatically updating the citation.
  
-==Suppress Authors: Using Authors in the Text==+==Omitting Authors: Using Authors in the Text==
  
-With author-date styles, authors are often moved into the text and omitted from the following parentheses-enclosed citation, e.g.: "...according to Smith (1776) the division of labor is crucial...". To omit the authors from the cite, check the "Suppress Author" box (this will result in a cite like "(1776)" instead of "(Smith, 1776)") and write the author's name ("Smith") as part of the regular text in your document. +With author-date styles, authors are often moved into the text and omitted from the following parentheses-enclosed citation, e.g.: "...according to Smith (1776) the division of labor is crucial...". To omit the authors from the cite, check the "Omit Author" box (this will result in a cite like "(1776)" instead of "(Smith, 1776)") and write the author's name ("Smith") as part of the regular text in your document. 
  
 ===Citations with Multiple Cited Items=== ===Citations with Multiple Cited Items===
Line 96: Line 103:
  
 You can switch to the [[/support/word_processor_plugin_usage_classic | "Classic View"]] citation dialog by clicking the "Z" icon on the left side of the Add Citation box, and selecting "Classic View". To permanently switch to the classic view check the "Use classic Add Citation view" checkbox in the [[preferences/cite|Cite]] pane of Zotero [[preferences]]. You can switch to the [[/support/word_processor_plugin_usage_classic | "Classic View"]] citation dialog by clicking the "Z" icon on the left side of the Add Citation box, and selecting "Classic View". To permanently switch to the classic view check the "Use classic Add Citation view" checkbox in the [[preferences/cite|Cite]] pane of Zotero [[preferences]].
 +
 +=====Editing the Bibliography===
 +
 +After you've inserted the bibliography using the “Add/Edit Bibliography” ({{:word_integration:zotero-toolbar-word-add-edit-bibliography-5.png?16&nocache&nolink}}) button, click the button again to open the Edit Bibliography window.
 +
 +{{ :word_processor_edit_bibliography.png?nolink&700 |}}
 +
 +In this window, you can add uncited sources to your bibliography (e.g., items included in a review but not cited in the paper) or remove items that are cited in text but which should not be included in the bibliography (e.g., personal communications).
 +
 +While it is also possible to edit the text or formatting of bibliography references in this window, doing so is discouraged. References edited here will not be automatically updated by Zotero if you change the data in your library. Editing references here is also somewhat unreliable; several users have reported that modifications made here sometimes do not persist when Zotero references, among other issues.
 +
 +If you need to edit items in your bibliography, it is best to do this as a final step before submitting the document. First, save a backup copy of the document. Then, click the "Unlink Citations" button ({{:word_integration:zotero-toolbar-word-unlink-citations-5.png?18&nocache&nolink}}) to disconnect your document from Zotero and convert all citations and the bibliography to regular text. Finally, make your adjustments to the bibliography text.
 +
 +This process can be used for a variety of minor modifications to the bibliography, including:
 +  * Adding asterisks * before references included in a review or meta-analysis
 +  * Setting the names of particular authors in bold, italics, or all caps
 +  * Adding annotations or comments about an item
 +  * Adding headings for bibliography subsections (e.g., primary versus secondary sources)
 +
 +**Note:** General corrections to style formatting should be made in the [[styles|CSL Citation Style]], not here. Corrections to item data should be made in your Zotero library, not here.
  
 =====Keyboard Commands===== =====Keyboard Commands=====
Line 101: Line 128:
 The Zotero LibreOffice plugin can be used with just the keyboard for improved accessibility and faster use. The Zotero LibreOffice plugin can be used with just the keyboard for improved accessibility and faster use.
  
-  * [[/support/word_processor_plugin_shortcuts|Keyboard shortcuts]] can be set up for all the buttons in the Zotero tab.+  * [[/support/word_processor_plugin_shortcuts#libreoffice|Keyboard shortcuts]] can be set up for all the buttons in the Zotero tab.
   * In the Citation dialog   * In the Citation dialog
     * Use the up and down arrow keys to move between search results. Press Enter to select an item.     * Use the up and down arrow keys to move between search results. Press Enter to select an item.
libreoffice_writer_plugin_usage.1512146013.txt.gz · Last modified: 2017/12/01 11:33 by bwiernik