vscode-zoterolens/README.md

# 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