List references from your local Zotero library and add them to a bib file.

Telescope zotero picker

Open entry prompt (Control-O over the current entry)

This does not provide autompletion in the document itself, as this is handled by https://github.com/jmbuhr/cmp-pandoc-references for entries already in references.bib. The intended workflow separates already used references from new ones imported from Zotero via this new plugin.

• Zotero
• Better Bib Tex

Add to your telescope config, e.g. in lazy.nvim

{
  'nvim-telescope/telescope.nvim',
  dependencies = {
    -- your other telescope extensions
    -- ...
    {
      'jmbuhr/telescope-zotero.nvim',
      dependencies = {
        { 'kkharji/sqlite.lua' },
      },
      -- options:
      -- to use the default opts:
      opts = {},
      -- to configure manually:
      -- config = function
      --   require'zotero'.setup{ <your options> }
      -- end,
    },
  },
  config = function()
    local telescope = require 'telescope'
    -- other telescope setup
    -- ...
    telescope.load_extension 'zotero'
  end
},

Default options:

---@type Zotero.Configuration
{
  -- File system options
  zotero_db_path        = '~/Zotero/zotero.sqlite',
  better_bibtex_db_path = '~/Zotero/better-bibtex.sqlite',
  zotero_storage_path   = '~/Zotero/storage',
  pdf_opener            = nil,

  -- Picker options
  picker = {
    with_icons = true,
    hlgroups = {
      icons       = 'SpecialChar',
      author_date = 'Comment',
      title       = 'Title',
    },
  },

  -- Filetype options (refer to next section)
  ft = { ... }
}

telescope-zotero.nvim supports formatting and references detection for the following filetypes:

For adding support for your filetype, you can add it to the ft table found in the options. Entries in the table accept two parameters:

• insert_key_formatter, a function that converts a citekey into a citation.
• locate_bib, a function that locates the references bib file used in the current buffer.

For example, we can add support for text filetype as follows:

opts = {
  fts = {
    text = {
      insert_key_formatter = function(citekey)
        return '[citation:' .. citekey .. ']'
      end,
      locate_bib = function()
        -- You function that locates the reference file in the current buffer
      end
    },
  },
}

For adding support for a specific filetype, please open a PR request.

Video (https://www.youtube.com/watch?v=_o5SkTW67do):

This extension is inspired by the following plugins that all do an amazing job, but not quite what I need. Depending on your needs, you should take a look at those:

• zotcite provides omnicompletion for zotero items in Quarto, Rmarkdown etc., but requires additional dependencies and uses a custom pandoc lua filter instead of a references.bib file
• zotex.nvim is very close, but as a nvim-cmp completion source, which doesn't fit with the intended separation of concerns.

Special Thanks to @kkharji for the sqlite.lua extension!