Neovim: Difference between revisions

From miki
Jump to navigation Jump to search
Line 149: Line 149:


== Neovim features ==
== Neovim features ==
Just a couple of things I should not forget exist.
* Powerful terminal emulation.
* Incremental substitution (<code>set inccommand=split</code>) (see [https://medium.com/@eric.burel/stop-using-open-source-5cb19baca44d#.k5y8is1ct here]).
* Incremental substitution (<code>set inccommand=split</code>) (see [https://medium.com/@eric.burel/stop-using-open-source-5cb19baca44d#.k5y8is1ct here]).



Revision as of 06:24, 13 January 2017

References

Install

See the guide Installing Neovim.

On Ubuntu, we install from repository:

sudo add-apt-repository ppa:neovim-ppa/unstable
sudo apt-get update
sudo apt-get install neovim

Default ini files are located at ~/.config/nvim/init.vim. To import Vim settings (FAQ :help nvim-from-vim)

mkdir ~/.config
ln -s ~/.vim ~/.config/nvim
ln -s ~/.vimrc ~/.config/nvim/init.vim

Configure nvim as default vim alternative:

sudo update-alternatives --install /usr/bin/vi vi /usr/bin/nvim 60
sudo update-alternatives --config vi
sudo update-alternatives --install /usr/bin/vim vim /usr/bin/nvim 60
sudo update-alternatives --config vim
sudo update-alternatives --install /usr/bin/editor editor /usr/bin/nvim 60
sudo update-alternatives --config editor


Ruby support

Must install neovim rubygem:

sudo apt install ruby-dev
sudo gem install neovim

Python support

sudo pip install neovim

Plugin manager

We install vim-plug:

curl -fLo ~/.config/nvim/autoload/plug.vim --create-dirs \
    https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim

Plugins

Content of ~/.config/nvim/init.vim:

Reload the init script and install plugins:

:so $MYVIMRC
"... or ':so %' if it is current file
:PlugInstall

To update plugins:

:PlugUpdate
To test
  • vim-airline, vs powerline, vs vim-bufferline
  • Color theme solarized.

NeoVim GUI

There is no equivalent to gvim for neovim so far. On Neovim related projects page, several GUI are listed. Among others:

  • nvim-qt
  • neovim-qt
  • NyaoVim (an advanced Electron UI based client)
  • ONI (another Electron UI based client)

Criteria for a good GUI:

  • Be fast.
  • Drop-in replacement for gvim / vim.
  • True color and italic support.
  • Blinking and customizable (block/caret) cursor.
NyaoVim / ONI

For now I discard these clients. These clients introduce additional features that I don't necessarily want.

nvim-qt

TBC.

Custom Gnome Terminal

The best I could do so far is to create a script gnvim that uses gnome-terminal as window, sets title to NeoVim, and sets icon using xseticon.

To install gnvim:

  • Copy neovim icon to /usr/local/icons/neovim.png. For instance, there is an icon in neovim-qt.git:
git clone https://github.com/equalsraf/neovim-qt.git
sudo mkdir -p /usr/local/icons
sudo cp neovim-qt/third-party/neovim.png /usr/local/icons
  • Create file gnvim, and make it executable:
#! /bin/bash
# We add a sleep 1 because of race condition between xseticon and echo
gnome-terminal --geometry 132x50 --hide-menubar -x bash -c "echo -ne '\033]0;NeoVim\007'; ((sleep 1; xseticon -name NeoVim /usr/local/icons/neovim.png)&); exec nvim $*"
  • To add NeoVim GUI as a desktop application, create the file ~/.local/share/applications/neovim.desktop:
#!/usr/bin/env xdg-open

[Desktop Entry]
Version=1.0
Type=Application
Terminal=false
Exec=/home/peetersm/bin/ngvim
Name=NeoVim
Comment=The future of Vim
Icon=/usr/local/icons/neovim.png

Then

chmod a+x ~/.local/share/applications/neovim.desktop

Tips

Use :term for Read–eval–print loop (REPL)

This can be easily done using a new buffer (C-w v) and a terminal (:term), and then

  • Use watch:
watch 'make this && less that'
  • Use entr:
echo myfile myotherfile | entr make this

Neovim features

Just a couple of things I should not forget exist.

  • Powerful terminal emulation.
  • Incremental substitution (set inccommand=split) (see here).

Troubleshooting

True color and italic support

See xterm.

Meta/Alt-key mappings choke (when typed too fast)

See bug #2454.

The solution is too actually install the plugin vim-sensible, contrary to what says :CheckHealth.

This plugins set ttimeoutlen to 100, which is sufficient to have alt-key mappings to act correctly in TUI.

nvim-qt - No blinking cursor

Adding call to QApplication::setCursorFlashTime() in main.cpp does not help. See issue #208.

Undefined variable: self

See issue #5763.

Last known good version without this bug for me: neovim_0.1.5ubuntu1+git201612110104+2963+22~ubuntu16.04.1_amd64.deb.

Bug fixed, but must update all plugins (:PlugUpdate) and vim-plug itself (with :PlugUpgrade).

incsearch plugin broken

See issue #125.

To Do

True color
Gui
Color scheme
  • Solarized
  • gruvbox
Linters
  • neomake
  • syntactics