Built from makenew/nvimrc.
Neovim configuration as a Neovim plugin.
This configuration system works as a meta-plugin:
all desired Neovim plugins are loaded from plugins.vim
using vim-plug,
and any GUI specific options are set in gui.vim
.
Overall configuration then follows a normal plugin structure.
For documentation of this Neovim configuration,
see :help nvimrc
or view nvimrc.txt directly.
A GUI is optional, but this config is also tested with neovim-qt.
The GUI font is Inconsolata-g, and vim-airline is set to use Powerline fonts.
- curl for downloading unicode data.
- The Silver Searcher (aka Ag), or ack, or grep.
- The fzf binary (vim-plug is not configured to manage it here).
Additionally, urxvt is configured as the fzf launcher for the GUI.
For fzf dictionary completion:
/usr/share/dict/words
. - See vim-fireplace for the Clojure specific plugin dependences.
- Supports local Node.js binaries installed with npm.
- Supports nvm if installed.
- Supports pyenv if installed.
- Supports rbenv if installed (rbenv-bundler recommended).
You can install this via the command-line with either curl
$ curl -L https://git.io/vwYRO | sh
or wget
$ wget https://git.io/vwYRO -O - | sh
-
Install vim-plug.
-
Create
~/.config/nvim/init.vim
with
" rxrc/nvimrc
if empty($XDG_CONFIG_HOME)
let $XDG_CONFIG_HOME = $HOME . '/.config'
endif
call plug#begin($XDG_CONFIG_HOME . '/nvim/plugged')
if filereadable($XDG_CONFIG_HOME . '/nvim/plugged/nvimrc/plugins.vim')
source $XDG_CONFIG_HOME/nvim/plugged/nvimrc/plugins.vim
if $NVIMRC_INSTALL != 'true'
Plug 'rxrc/nvimrc'
endif
else
Plug 'rxrc/nvimrc', { 'on': [] }
endif
call plug#end()
and ~/.config/nvim/ginit.vim
with
" makenew/nvimrc
if empty($XDG_CONFIG_HOME)
let $XDG_CONFIG_HOME = $HOME . '/.config'
endif
source $XDG_CONFIG_HOME/nvim/plugged/nvimrc/gui.vim
- Run
$ nvim -c PlugInstall
$ NVIMRC_INSTALL=true nvim -c PlugInstall
Updating is handled via the normal vim-plug commands.
Here is an example of a shell function that will provide a one-step update:
# Upgrade nvimrc.
function nvimupg () {
if ! [[ -e $XDG_CONFIG_HOME/nvim/autoload/plug.vim ]]; then
echo 'vim-plug is not installed.'
return 1
fi
nvim -c PlugUpgrade
nvim -c PlugUpdate
nvim -c PlugInstall
nvim -c PlugClean!
}
The nvimrc source is hosted on GitHub. Clone the project with
$ git clone https://github.com/rxrc/nvimrc.git
You can switch to development mode which will configure vim-plug to use the local directory as the plugin path.
First, follow the normal install steps if you haven't already. Then, switch to development mode with
$ ./install.sh dev
Switch out of development mode with
$ ./install.sh
Please submit and comment on bug reports and feature requests.
To submit a patch:
- Fork it (https://github.com/rxrc/nvimrc/fork).
- Create your feature branch (
git checkout -b my-new-feature
). - Make changes.
- Commit your changes (
git commit -am 'Add some feature'
). - Push to the branch (
git push origin my-new-feature
). This software can be used freely, see [The Unlicense]. The copyright text appearing below and elsewhere in this repository is for demonstration purposes only and does not apply to this software.
This Neovim config is licensed under the MIT license.
This software is provided "as is" and without any express or implied warranties, including, without limitation, the implied warranties of merchantibility and fitness for a particular purpose.