Home

Awesome

citation-langserver

citation-langserver is a language server for working with citations stored in BibTeX or BibLaTeX files.

citation-langserver supports code completion, hover, jump to definition, and find references. It supports absolute file paths for bibliographies, relative file paths, as well as glob-based file paths. It is compatible with all clients that support the Language Server Protocol

Installation

Run pip3 install citation-langserver to install.

Usage

Configure citation-langserver as you would any other LSP in your text editor of choice.

For instance, using CoC in Vim, you might add the following to your coc-settings.json file:

  "languageserver": {
    "citation": {
      "command": "/usr/local/bin/citation-langserver",
      "filetypes": ["markdown"],
      "settings": {
        "citation": {
          "bibliographies": [
            "~/library.bib",
			"./*.bib"
          ]
        }
      }
    }
  }

Configuration

The setting citation.bibliographies needs to be sent by the client to the server and contain an array of file paths. The file paths can include: