Zotcite is a Vim plugin that provides integration with Zotero. With zotcite you can:
-
Do omni completion of citation keys from Zotero database in Markdown, RMarkdown and Quarto documents.
-
Quickly see on the status bar information on the reference under the cursor.
-
Use the
zotref.pyfilter to pre-process the Markdown document before the citations are processed bypandoc, avoiding the need ofbibfiles. -
Open the PDF attachment of the reference associated with the citation key under the cursor.
-
Extract highlighted text and text notes from PDF attachments of references.
-
Extract Zotero notes from Zotero database.
-
Add all cited references to the YAML header of the Markdown document.
Zotcite is being developed and tested on Linux and should work flawlessly on other Unix systems, such as Mac OS X. It may require additional configuration on Windows.
Requirements:
-
Zotero >= 5
-
Python 3
-
Python 3 modules pynvim (see Neovim documentation on
provider-pythonfor details) and PyYAML. -
Python modules PyQt5 and python-poppler-qt5 (only if you are going to extract annotations from PDF documents). On Debian based Linux distributions, you can install them with the command:
sudo apt install python3-pyqt5 python3-poppler-qt5
Depending on your system, you may have to install python modules in an virtual environment and maybe also system-wide.
Zotcite can be installed as any Vim plugin. If using Neovim, you may also want to install cmp-zotcite.
The Python module zotero does not import the vim module. Hence, its code
could easily be adapted to other text editors or as a language server for
markdown and quarto.
Please, read the plugin's documentation for further instructions.
Zotcite syntax highlighting will not be enabled if the file type is pandoc.
Zotcite's Python code was based on the citation.vim project.