# zoterolens README

Zoterolens scans Markdown files for possible citationkeys and adds links open then with Zotero. Also a convenient option to immediately open the cited pdf-file.

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.

## 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]

## Requirements

* Zotero
* Zotero's Better-Bibtex plugin

## 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 happen _before_ showing the ref.
* No error if Zotero isn't running, or the Better-Bibtex plugin is not configured.
* Does not yet consider the page number of the citation when opening the pdf.
* Zotero port cannot yet be configured.
* explorer TreeView showing references.
* Possibly use CodeAction instead of Lens: https://code.visualstudio.com/api/language-extensions/programmatic-language-features#possible-actions-on-errors-or-warnings


## Release Notes

### 1.0.0

Initial release of Zoterolens