1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
|
# vim-lsp-settings
[](https://github.com/mattn/vim-lsp-settings/actions)
[](https://github.com/mattn/vim-lsp-settings/actions)
[](https://github.com/mattn/vim-lsp-settings/actions)
[](https://github.com/mattn/vim-lsp-settings/actions)
[](https://github.com/mattn/vim-lsp-settings/actions)
[](https://github.com/mattn/vim-lsp-settings/actions)
Auto configurations for Language Server for [vim-lsp](https://github.com/prabirshrestha/vim-lsp)
## Introduction
Language Servers is not easily to install. Visual Studio Code provide easy way to install/update Language Server and Language Server Client. This plugin provide same feature on Vim.
## Installation instruction
For [vim-plug](https://github.com/junegunn/vim-plug) plugin manager:
```viml
Plug 'prabirshrestha/async.vim'
Plug 'prabirshrestha/asyncomplete.vim'
Plug 'prabirshrestha/asyncomplete-lsp.vim'
Plug 'prabirshrestha/vim-lsp'
Plug 'mattn/vim-lsp-settings'
```
You need to install both [vim-lsp](https://github.com/prabirshrestha/vim-lsp) and its accompanying plugins and vim-lsp-settings.
### Notice
If you use plugin manager that is merging plugins (ex. dein), Please setting stop merging work(ex. dein / merged = 0) or set `g:lsp_settings_servers_dir` option to a different directory from the vim-lsp's default.
_reason_:
Servers are installed in `./servers` directory at the caching area in default.
But when rebuild the cache, any merging plugin manager erases old cached files(include `./servers` and server execute files) before install.
You can change the directory to install servers by set `g:lsp_settings_servers_dir` option in full path.
## Usage
```
:LspInstallServer
```
Currently, no way to uninstall/update server. Run this command again, newer version will be installed.
## Supported Languages
| Language | Language Server | Local Install |
|------------|--------------------------------------------------------|:-------------:|
| C/C++ | clangd | Yes |
| C# | omnisharp | Yes |
| Clojure | clojure-lsp | Yes |
| TypeScript | typescript-language-server | Yes |
| JavaScript | typescript-language-server | Yes |
| JavaScript | javascript-typescript-stdio | Yes |
| Python | pyls | Yes |
| Python | pyls-ms (Microsoft Version) | Yes |
| Rust | rls | No |
| Go | gopls | Yes |
| Ruby | solargraph | Yes |
| PHP | intelephense | Yes |
| Java | eclipse-jdt-ls | Yes |
| Lua | emmylua-ls | Yes |
| Vim | vim-language-server | Yes |
| Bash | bash-language-server | Yes |
| Terraform | terraform-lsp | Yes |
| Dockerfile | dockerfile-language-server-nodejs | Yes |
| YAML | yaml-language-server | Yes |
| XML | lsp4xml | Yes |
| Fortran | fortls | Yes |
| Scala | Metals | Yes |
| Elm | elm-language-server | Yes |
| JSON | json-languageserver | Yes |
| Swift | sourcekit-lsp | No |
| COBOL | cobol-language-support | Yes |
| Reason | reason-language-server | Yes |
| TeX | texlab | Yes |
| TeX | digestif | No |
| Nim | nimls | No |
| D | dls | No |
| Elixir | elixir-ls | Yes |
| Groovy | groovy-language-server | Yes |
| Dart | analysis-server-dart-snapshot | Yes |
| Erlang | erlang-ls | Yes |
| F# | fsharp-language-server | Yes |
| GraphQL | gql-language-server | Yes |
| Vue | vue-language-server | Yes |
| SQL | sql-language-server | Yes |
| Lisp | cl-lsp | No |
| * | efm-langserver | Yes |
## Notes
### clangd (C/C++)
There is a Linux OS/version that does not run locally installed clangd due to zlib version mismatch. If you want to use clangd, please install clangd on your system.
### rls (Rust)
If you install rls already, you can use rls without configurations. But if you not installed rls yet, you can install it by following [this instruction](https://github.com/rust-lang/rls#setup).
### gql-language-server (GraphQL)
To use gql-language-server, `.gqlconfig` have to be located on the top of project directory. And schema must be pointed to the schema file correctly.
```json5
{
schema: {
files: 'path/to/schema.graphql'
}
}
```
Finally, you have to install `@playlyfe/gql` into your project.
```
$ npm install @playlyfe/gql --save-dev
```
## Configurations
Most of configurations are not required.
If you install clangd already, you can use clangd for C/C++ without configurations. But if you install clang with named clangd-6.0, you can replace executable like below:
```vim
let g:lsp_settings = {
\ 'clangd': {'cmd': ['clangd-6.0']}
\}
```
Overridable keys are:
* cmd (List ex: `['clangd-6.0', '-enable-snippets']`)
* initialization_options (Dictionary)
* whitelist (List)
* blacklist (List)
* config (Dictionary)
* workspace_config (Dictionary)
If you install ruby but not solargraph, you can install solargraph with following command.
If you have some Language Servers and want to use specified the server:
```vim
let g:lsp_settings_perl = 'slp'
```
If you want to disable Language Server:
```vim
let g:lsp_settings = {
\ 'perl-languageserver': {
\ 'disabled': 1,
\ }
\}
```
## License
MIT
## Author
Yasuhiro Matsumoto (a.k.a. mattn)
|
