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
|
# Introduction
This is my Neovim configuration for all the platforms I use. `init.vim` is for
terminal Neovim and `ginit.vim` is for neovim-qt on Windows.
# Install
## Linux
Just follow the official guide and download the `appimage` from the [release
page](https://github.com/neovim/neovim/releases/nightly).
For some Linux system, you may not be able to run the appimage. You can
directly download the tar ball from
[here](https://github.com/neovim/neovim/releases/download/nightly/nvim-linux64.tar.gz)
and extract it.
## Windows
First, install [chocolatey](https://chocolatey.org/install). Then you can
install neovim easily with
```
# install latest version of neovim
# choco install neovim --pre
choco install neovim
```
Or you can download the latest release from GitHub and extract it.
## Mac
It is recommended to install neovim via [Homebrew](https://brew.sh/). Simply
run the following command:
```
# if you want to install latest version of neovim
# brew install --HEAD neovim
brew install neovim
```
After Neovim installation, you may need to add the directory where the neovim
executable (`nvim` on Linux and Mac, `nvim.exe` on Windows) resides to your
`PATH`.
Make sure that you can call `nvim` from the command line.
# Other tools to install
## Python
Neovim supports both Python2 and Python 3. But python 3 is preferable. Neovim
will automatically detect the Python version you use.
## pynvim
Neovim relies on [pynvim](https://github.com/neovim/pynvim) to communiate with
plugins which uses its Python binding.
## Git
Git is used by plugin managers to download plugins from Github or other Git
repositories.
Since Git is usually pre-installed on Linux and Mac, you do not need to worry
if you are using these two platforms. For Windows, install [Git for
Windows](https://git-scm.com/download/win) and make sure you can call `git`
from command line.
## ctags
In order to tags related plugins such as
[tagbar](/github.com/majutsushi/tagbar) and
[gutentags](https://github.com/ludovicchabant/vim-gutentags), you need to a
ctags distribution. Universal ctags is prefered.
To insall ctags on Mac, [use
Homebrew](https://github.com/universal-ctags/homebrew-universal-ctags). To
install it Windows, [use
chocolatey](https://chocolatey.org/packages/universal-ctags):
```
choco install universal-ctags
```
To install it on Linux, you need to build it yourself. See
[here](https://askubuntu.com/questions/796408/installing-and-using-universal-ctags-instead-of-exuberant-ctags/836521#836521).
Set its PATH properly and make sure you can call `ctags` from command line.
## Ripgrep
Ripgrep is fast grep tool available for both Linux, Windows and Mac. It is used
several greping plugins for Vim.
For Windows and Mac, you can install via chocolatey and homebrew. For Linux,
you can download from the [release
page](https://github.com/BurntSushi/ripgrep/releases) and install it.
## linters
Based on your programming languages, you may need to install various linters.
+ Python: [pylint](https://github.com/PyCQA/pylint) and
[flake8](https://github.com/PyCQA/flake8).
+ Vim script: [vint](https://github.com/Kuniwak/vint) (You may need to install
the pre-release versions because of [this issue](https://github.com/Kuniwak/vint/issues/290)).
For other linters, please consult the linting plugin documentation. For Neomake
(which is the lint plugin I use), a list of makers (i.e., linters) for
different languages is listed
[here](https://github.com/neomake/neomake/wiki/Makers).
# settings
## Where to put the configuration file
On Windows, put it under `$HOME/AppData/Local/nvim`[^1]. On Linux and Mac, put
it under `~/.config/nvim`.
## Make deoplete work
To make deoplete work, you have to set the correct value for
`g:python3_host_prog`. You should set it to the full path to your Python3
executable. Find this setting in this `init.vim` and change it in accordance
with your system.
## Further reading
+ [Config nvim on Linux for Python development](https://jdhao.github.io/2018/12/24/centos_nvim_install_use_guide_en/)
+ [Nvim config on Windows 10](https://jdhao.github.io/2018/11/15/neovim_configuration_windows/)
+ [Nvim-qt config on Windows 10](https://jdhao.github.io/2019/01/17/nvim_qt_settings_on_windows/)
[^1]: Use `echo %userprofile%` to see where your `$HOME` is.
|
