Skip to content

AllanChain/zotero-arxiv-workflow

Repository files navigation

arXiv Workflow for Zotero

GitHub release Using Zotero Plugin Template total downloads

This Zotero plugin addresses the pain when you store papers from arXiv and want to update your Zotero entry when they are published.

Warning

This plugin is in alpha stage and only suports Zotero 7 beta!

✨ Features

  • 🪢 Merge a preprint item and a journal article item without pain
  • 🗃️ Easy to set which PDF to open by default
  • 📄 Search online if a arXiv paper is published and update the information and PDF accordingly
  • 🌐 Download the latest version of published PDF

🤔 Why?

Easier workflow with arXiv paper!

  • The Zotero built-in merging feature does not support merging items of different type, therefore an arXiv paper and a journal article cannot merge.
  • I need the journal information from the journal item, while keeping the ID the same as the arXiv one. Because many plugins store data based on item ID, and I do not want to lose them.

📸 Screenshots

Merge arXiv Prefer PDF
Screenshot of merge arXiv Screenshot of prefer PDF

🔧 Installation

Download zotero-arxiv-workflow.xpi from the release page. Firefox users need to right-click on the link and use "Save link as" instead of direct downloading it. After downloading, click "Tools" > "Plugins" in Zotero menu and drag the downloaded file into the dialog.

🎈 How to Use

🪢 Merge arXiv paper and the published one

  1. Save the arXiv version into Zotero
  2. Save the published version into Zotero
  3. Select both items, right click
  4. Select "Merge arXiv"

This will update the arXiv item with all the information from the journal item except for the URL and dateAdded. The journal item will be deleted and the original arXiv item will have type journalArticle.

This will also make the published PDF as the default PDF.

🗃️ Prefer to open a specific PDF

If you have merged some entries manually, those entries will by default open the arXiv PDF. To make Zotero open the published PDF by default, you can select the published PDF, right click, and select "Prefer this PDF".

📄 Search for published version of an arXiv paper

If you have a preprint item for the arXiv paper, and you want to find if it has been published and update the information, you can right click on the preprint item and select "Update to a published one". This will search arxiv.org for the "Related DOI" field, which may be updated if the paper got published. If nothing is found, we will fall back to the Semantic Scholar API.

Note

It is not trivial to correctly find the published version. If it fails, you'd better add the journal article item manually and use the merge feature this plugin provides.

If a published version is found, a new item will be created automatically and the published PDF will be downloaded. Then the preprint item and the newly created journal item will be merged.

🌐 Download published PDF

Say you have an arXiv paper PDF and import it into Zotero. Zotero finds that it has been published and uses the information from the published version. A few days later you might want to download the published version because it might be different from the arXiv one. With original Zotero, you have to open the journal URL, download the PDF, and add it as an attachment. With this plugin, it is as easy as right click and select "Download published PDF".

💻 Development

This repo is created from the Zotero plugin template, please follow the quick start guide.

The following resources are also helpful: