These are instructions for using the Zotero LibreOffice Plugin. For the Word plugin, see here.
Installing the Zotero LibreOffice plugin adds a Zotero toolbar to LibreOffice.
The Zotero toolbar contains these icons:
|Add/Edit Citation||Add a new citation or edit an existing citation in your document at the cursor location.|
|Add/Edit Bibliography||Insert a bibliography at the cursor location or edit an existing bibliography.|
|Document Preferences||Open the Document Preferences window, e.g. to change the citation style.|
|Refresh||Refresh all citations and the bibliography, updating any item metadata that has changed in your Zotero library.|
|Unlink Citations|| Unlink Zotero citations in the document by removing the field codes and converting citations to regular text. This prevents any further automatic updates of the citations and bibliographies.
Note that removing unlinking citations is irreversible, and should usually only be done in a final copy of your document.
You can begin citing with Zotero by clicking the “Add/Edit Citation” () button. Pressing the button brings up the citation dialog.
The citation dialog is used to select items from your Zotero library, and create a citation.
Start typing part of a title, the last names of one or more authors, and/or a year in the dialog box. Matching items will instantly appear below the dialog box.
Matching items will be shown for each library in your Zotero database (My Library and any groups you are part of). Items you have already cited in the document will be shown at the top of the list under “Cited”.
Select an item by clicking on it or by pressing Enter/Return when it is highlighted. The item will appear in the dialog box in a shaded bubble. Press Enter/Return again to insert the citation and close the Add Citation box.
In the Add Citation dialog box, you can click on the bubble for a cited item, then click “Open in My Library (or the Group Library's name)” to view the item in Zotero. Items that are orphaned (not connected to any items in your Zotero database) will not have an “Open in My Library” button. Orphaned items can exist if they were inserted by a collaborator from their My Library or a group you don't have access to or if you they were deleted from your Zotero library.
Clicking the “Add/Edit Bibliography” () 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. See below. Manual edits made to the bibliography in LibreOffice will be overwritten the next time Zotero refreshes the document.
The “Document Preferences” window lets you set the following document-specific preferences:
Cites can be customized in various ways. To start, click the shaded cite in the Add Citation box to open the cite options window.
In some cases you want to cite a certain part of an item, e.g. a certain page, page range or volume. This additional cite-specific information (e.g. “pp. 4-7” in the cite “Doe et al. 2001, p. 4-7”) is called the “locator”.
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 “Prefix” and “Suffix” text boxes allow you to specify text to respectively precede and follow the automatically generated cite. For example, instead of “Tribe 1999”, you might want “cf. Tribe 1999, see also…”.
Any text in the prefix and suffix fields can be formatted with the HTML tags <i> (for italics), <b> (bold), <sub> (subscript), and <sup> (superscript). For example, typing ”<i>cf</i>. the classic example“ will be displayed as ”cf. the classic example“.
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.
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.
To create a citation containing multiple cites (e.g., ”[2,4-6]“ for numeric styles or ”(Smith 1776, Schumpeter 1962)“ for author-date styles), add them one after the other in the Add Citation box. After selecting the first item, don't press Enter/Return, but type the author, title, or year of the next item.
Some citation styles require that items within one in-text citations are ordered either alphabetically (e.g., ”(Doe 2000, Grey 1994, Smith 2008)“) or chronologically (”(Grey 1994, Doe 2000, Smith 2008)“). Zotero will follow these sort rules automatically.
You can switch to the "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 Cite pane of Zotero preferences.
After you've inserted the bibliography using the “Add/Edit Bibliography” () button, click the button again to open the Edit Bibliography window.
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 () 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:
Note: General corrections to style formatting should be made in the CSL Citation Style, not here. Corrections to item data should be made in your Zotero library, not here.
The Zotero LibreOffice plugin can be used with just the keyboard for improved accessibility and faster use.
If you run into problems while trying to use the Zotero LibreOffice plugin, make sure to check out the word processor plugin troubleshooting page.