Skip to content

Commit

Permalink
Overhaul Zotero usage page
Browse files Browse the repository at this point in the history
  • Loading branch information
NeuroShepherd committed Sep 4, 2024
1 parent ddf9cd6 commit d58c360
Show file tree
Hide file tree
Showing 17 changed files with 85 additions and 19 deletions.
Binary file added assets/01_library.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/01_palmerpenguins.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/01_palmerpenguins_manual.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/02_new_folder.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/02_palmerpenguins.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/02_palmerpenguins_manual.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/03_empty_folder.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/03_palmerpenguins.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/03_palmerpenguins_manual.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/04_citation_in_folder.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/04_palmerpenguins.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/04_palmerpenguins_manual.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/05_palmerpenguins_manual.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/05_tag_object.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/06_custom_tag.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/07_search_tag.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
104 changes: 85 additions & 19 deletions zotero_usage.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -3,51 +3,117 @@ title: "Using Zotero"
format: html
---


# Creating a Zotero Library

Zotero's library system functions similar to a file system on your computer. You can create folders to organize your references, and add tags to references to help you find them later. The images below show how to create a new folder in Zotero, and what a fresh folder looks like.

::: {.panel-tabset}

## 1. General Library

![All of your citations can be accessed in the overall **My Library** section.](assets/01_library)

## 2. Creating a New Folder

![Press the folder button in the top left corner to create a new folder, and provide a relevant name.](assets/02_new_folder)

## 3. A Fresh Folder

![A new folder will be empty by default, and will now appear in the tab bar on the left size of the Zotero application.](assets/03_empty_folder)

:::



# Adding References

The first step to using Zotero is adding references to your library. You can add references to Zotero in several ways:
While creating libraries/folders for your projects is highly recommended and useful, the more important step in using Zotero is adding references to your library. You can add references to Zotero in several ways:

- Save to Zotero with the Zotero Connector browser extension
- Manual entry
- Import from online databases.
- Import from other software.

We will outline the first two methods here, as they are the most common ways to add references to Zotero.

## Zotero Connector

The most common and preferred way of entering references is by using the Zotero Connector browser extension. The Zotero Connector allows you to save references directly from your browser to your Zotero library. The connector will, when possible, download a PDF of the article and attach it to the reference. If you save content from a webpage that does not have an available PDF download of the content, the Connector will take a snapshot of the webpage to preserve the information in case the page is later changed or removed.

The Zotero Connector is not perfect, however, and you may occassionally need to "manually" enter a reference. To do this, click on the "New Item" button in Zotero, and select the type of reference you want to add. You can then enter the metadata for the reference manually. However, if you can find a BibTex or RIS file for the reference, you can import the reference into Zotero by dragging and dropping the file into the Zotero window, or by copying the BibTex content and then selecting `File` -\> `Import from Clipboard` in Zotero.
::: {.panel-tabset}

Less commonly, you may need to import references from other software. To do this, export the references from the software in a compatible format, and import them into Zotero. Zotero can import references from a variety of formats, including BibTex, RIS, and EndNote XML.
## 1. Locate Source

![Identify the publication, book, website, or other source of information you wish to cite.](assets/01_palmerpenguins)

## 2. Open Link

![Open the website page. Try to find links to PubMed, the original publisher, or similar sites that have PDFs available. Zotero will automatically download these when available. Otherwise, it will attempt to screenshot the website itself.](assets/02_palmerpenguins)

## 3. Download

![Click the Zotero Connector button in your browser to save the reference to your Zotero library. The button is generally in the top right corner of your browser. The appearance of this button *can* change depending on the type of object being cited.](assets/03_palmerpenguins)

## 4. Check Library

![After saving the reference, check your Zotero library to ensure the reference was saved correctly.](assets/04_palmerpenguins)

:::

## Manual Entry

The Zotero Connector is not perfect, however, and you may occassionally need to "manually" enter a reference. To do this, click on the "New Item" button in Zotero, and select the type of reference you want to add. You can then enter the metadata for the reference manually. However, if you can find a BibTex or RIS file for the reference, you can import the reference into Zotero by dragging and dropping the file into the Zotero window, or by copying the BibTex content and then selecting `File` -\> `Import from Clipboard` in Zotero.

The example below will demonstrate how to manually import a BibTex entry.

::: {.panel-tabset}

## 1. Locate Source

![Identify the object you want to cite. If you can find the publication on Google Scholar, for example, BibTex entries are readily available. Click on the "Cite" button in Google Scholar to access the BibTex entry.](assets/01_palmerpenguins_manual)

## 2. Open Citation

![Click on the "BibTex" button in Google Scholar to access the BibTex entry.](assets/02_palmerpenguins_manual)

## 3. Copy BibTex

![Copy the BibTex entry to your clipboard.](assets/03_palmerpenguins_manual)

## 4. Import to Zotero

![In Zotero, click on `File` -\> `Import from Clipboard` to import the BibTex entry.](assets/04_palmerpenguins_manual)

## 5. Check Library

![After importing the BibTex entry, check your Zotero library to ensure the reference was saved correctly. Note how much less information is included by importing BibTex, however. Compared to the Zotero Connector, we are, at minimum, missing a PDF copy of the document and the date on which we accessed the material.](assets/05_palmerpenguins_manual)

:::

Less commonly, you may need to import references from other software. To do this, export the references from the software in a compatible format, and import them into Zotero. Zotero can import references from a variety of formats, including BibTex, RIS, and EndNote XML.

# Citing references

The main point of using Zotero, of course, is to cite references in your documents. Zotero makes this easy by providing plugins for popular word processors like Microsoft Word and LibreOffice. [These word processor plugins](https://www.zotero.org/support/system_requirements#word_processors) should be installed automatically when you install Zotero.
The main point of using Zotero, of course, is to cite references in your documents. Zotero makes this easy by providing plugins for popular word processors like Microsoft Word and LibreOffice. [These word processor plugins](https://www.zotero.org/support/system_requirements#word_processors) should be installed automatically when you install Zotero.

To cite a reference in your document, click on the "Add/Edit Citation" button in the Zotero toolbar, and search for the reference you want to cite. Zotero will insert a citation in the text, and generate a bibliography at the end of the document.
Later chapters will detail how to use Zotero with RStudio + Quarto and Word, specifically. We briefly detail here how to generate a bibliography directly from Zotero.

## Generating Bibliographies

If using Zotero with a word processor, you can generate a bibliography by clicking on the "Insert Bibliography" button in the Zotero toolbar. This will insert a bibliography at the current cursor location in your document.

Alternatively, you can generate a bibliography by clicking on the "Export" button in Zotero, and selecting the citation style you want to use. This will generate a bibliography in the selected style that you can copy and paste into your document. You can generate a bibliography for a single reference, a collection (i.e. a folder), or your entire library.
You can generate a bibliography by clicking on the "Export" button in Zotero, and selecting the citation style you want to use. This will generate a bibliography in the selected style that you can copy and paste into your document. You can generate a bibliography for a single reference, a collection (i.e. a folder), or your entire library. This option to quickly generate a bibliography is useful if you are using a text editor that does not have a Zotero plugin, or if you simply need a one-and-done bibliography for a smaller project

For more details, see the [Zotero documentation on creating bibliographies](https://www.zotero.org/support/creating_bibliographies).

# Other Features

- Less important, but still interesting, features offered by Zotero
- Optional to learn this content
This page has covered the basics of using Zotero, but there are many other features that Zotero offers that you may find useful. Some of these topics will be covered in more detail in optional chapters at the end of this tutorial, but here are a few other features that you may find useful:

## Organizing References

- You can organize your references in Zotero by creating collections and tags.
- To create a collection, click on the "New Collection" button, and give the collection a name.
- To add references to a collection, drag and drop the references into the collection.
- To add tags to a reference, click on the "Tags" tab, and enter the tags you want to add.
You can organize your references in Zotero by creating collections and tags. To create a collection, click on the "New Collection" button, and give the collection a name. To add references to this collection, simply drag and drop the references into the collection. To add tags to a reference, click on the "Tags" tab, and enter the tags you want to add. These tags are particularly convenient if you want to later search your library for references on a specific topic as defined by you.

## Collaborating with others

- You can collaborate with others by sharing your references with them.
- To share your references, click on the "Share" button, and select the people you want to share with.
- To receive shared references, click on the "Receive Shared Library" button, and enter the URL of the shared library.

## Collaborating with others

You can also collaborate with others by sharing your references with them, generally by creating a Zotero Group. The contents of these groups are shared with all members online, and you can set the group to be public or private. Public groups are open to anyone, while private groups require an invitation to join. You can also create a group library, which is a shared library that all members can edit. This is useful if you are working on a project with others and want to share references with them.

0 comments on commit d58c360

Please sign in to comment.