vscode-zoterolens/README.md

48 lines
1.2 KiB
Markdown

# Zoterolens
Zoterolens scans Markdown files for citation-keys and adds inline links to open their attached pdf's with Zotero. An optional page number is taken into account.
I recommend using it in combination with an extension such as [Citation Picker for Zotero](https://marketplace.visualstudio.com/items?itemName=mblode.zotero), and/or [Pandoc Citer](https://marketplace.visualstudio.com/items?itemName=notZaki.pandocciter) to be able to easily add citations.
## Requirements
* Zotero (needs to be running)
* Zotero's Better-Bibtex plugin
## Features
- CodeLens to open PDF's based on citekey
- CodeLens to select item in Zotero based on citekey
It should find the page number following cases:
- @test123
- @test1.23
- @test123 89
- @test123, 89
- [@test123, 89]
- @test123 [89]
- [@test123, p.89]
- [@test123, pp.89-92]
- [@test123, pp.89--92]
## Extension Settings
none.
## Known Issues / Wishlist
* It does not yet check if the citekey actually exists in Zotero, nor if it actually has any attachment.
* This should be made to happen _before_ showing the ref.
* No error if Zotero isn't running, or the Better-Bibtex plugin is not configured.
* Zotero port cannot yet be configured.
## Release Notes
### 0.1.0
Initial pre-release of Zoterolens