bibli-ls 0.1.4.1

A simple LSP server for your bibliographies

Bibli Language Server

A Language Server that brings bibliographies into your notes.

Supported LSP capabilities

LSP Features	Behavior
textDocument/definition	Go to the first definition found in the .bib files.
textDocument/references	Find appearance of prefix + ID with ripgrep.
textDocument/hover	Show metadata from .bib files based on configurations.
textDocument/completion	Triggered by the cite_prefix configuration. Show completion of citation ID for bibtex entries and their documentation.
textDocument/diagnoistic	Find citations without a proper entry in the bibfile.

Configuration

Create a configuration file .bibli.toml at the root of your note directory. Here is a sample configuration:

bibfiles = ["references.bib"] # Relative/Absolute path to your bibliographies

[cite]
prefix = "@" #

[hover.doc_format]
show_fields = ["abstract", "year", "booktitle", "url"]
format = "table" # Available formats: "table"  and "list" (markdown)

[completion.doc_format]
show_fields = ["abstract", "year", "booktitle"]
format = "list"

Installation

Install the latest release of bibli-ls through pip:

pip install bibli-ls

Neovim

Automatic configuration through lspconfig has yet to be supported. To enable bibli-ls, put the following code in your Neovim config.

local lspconfig = require("lspconfig")
local configs = require("lspconfig.configs")

if not configs.bibli_ls then
 configs.bibli_ls = {
  default_config = {
   cmd = { "bibli_ls" },
   filetypes = { "markdown" },
   root_dir = lspconfig.util.root_pattern(".bibli.toml"),
  },
 }
end

lspconfig.bibli_ls.setup({})

Planned Features (TODO)

• Universal: Works with any note format
• LSP-native configurations
• Per-document bibliographies
• More LSP capabilities
  • mkdnflow.nvim-like opening of URL
  • Code actions