NotAShelf/nvf
2
1
Fork 0
mirror of https://github.com/NotAShelf/nvf.git synced 2025-09-05 18:01:32 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

docs: udpate documentation on language LSPs

Browse source
This commit is contained in:
Ching Pei Yang 2025-08-30 16:12:07 +02:00
commit ebda7c9000
No known key found for this signature in database
GPG key ID: B3841364253DC4C8
1 changed files with 29 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

41
docs/manual/configuring/languages/lsp.md
View file

@ -1,23 +1,40 @@
# LSP Custom Packages/Command {#sec-languages-custom-lsp-packages} # Configuring supported LSP servers {#sec-languages-configuraing-lsp-servers}
One of the strengths of **nvf** is convenient aliases to quickly configure LSP One of the strengths of **nvf** is convenient aliases to quickly configure LSP
servers through the Nix module system. By default the LSP packages for relevant servers through the Nix module system. By default the LSP packages for relevant
language modules will be pulled into the closure. If this is not desirable, you language modules will be pulled into the closure. If this is not desirable, you
may provide **a custom LSP package** (e.g., a Bash script that calls a command) may modify [](#opt-vim.lsp.servers._name_.cmd) (see example below).
or **a list of strings** to be interpreted as the command to launch the language
server. By using a list of strings, you can use this to skip automatic Any other forms of configuration can be done via [](#opt-vim.lsp.servers), which
installation of a language server, and instead use the one found in your `$PATH` is a wrapper for the neovim lua API `vim.lsp.config()`. Getting familiar with
during runtime, for example: `:help vim.lsp.config()` may help you better understand how to configure LSPs.
```nix ```nix
vim.languages.java = { {
lsp = { vim.languages.python = {
enable = true; enable = true;
lsp = {
enable = true;
# You can now enable multiple LSPs per language
servers = ["basedpyright"];
};
};
# This expects 'jdt-language-server' to be in your PATH or in # vim.lsp.servers is a wrapper for the lua API vim.lsp.config
# 'vim.extraPackages.' There are no additional checks performed to see # (see :help vim.lsp.config)
# if the command provided is valid. vim.lsp.servers = {
package = ["jdt-language-server" "-data" "~/.cache/jdtls/workspace"]; basedpyright = {
# `vim.languages.<lang>.lsp.package` is now removed, you have to
# modify the cmd field, and remember to copy over the arguments!
cmd = [(getExe pkgs.myCustomPackage) "--stdio"];
# server specific settings, see documentation of the respective language
# servers
settings = {
basedpyright.analysis.logLevel = "Error";
python.pythonPath = getExe pkgs.myPython3;
};
};
}; };
} }
``` ```