bibli-ls 0.1.3.1

A simple LSP server for your bibliographies

Bibli Language Server

A Language Server that brings bibliographies into your note-taking workflows.

Supported LSP capabilities

LSP Feature	Behavior
textDocument/definition	Go to the first definition found in the .bib files.
textDocument/references	Find appearance of prefix + ID through ripgrep.
textDocument/hover	Show metadata from .bib files based on configurations.
textDocument/completion	Triggered by the cite_prefix configuration or [, {, <. Show completion of citation ID for bibtex entries and their documentation.

Configuration

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

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

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

[completion]
cite_prefix = "@"

Installation

Install the latest release of bibli-ls through pip:

pip install bibli-ls

Neovim

Automatic configuration through lspconfig is not supported yet. 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
• Per-document bibliographies
• More LSP capabilities
  • mkdnflow.nvim-like opening of URL
  • Code actions