Neovim Configuration

Built from makenew.github.io.

Neovim configuration as a Neovim plugin.

Description

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.

If NVIM_APPNAME is set, installation and runtime paths follow that app name. Otherwise, the default nvim paths are used.

For documentation of this Neovim configuration, see :help nvimrc or view nvimrc.txt directly.

Requirements

GUI

A GUI is optional, but this config is also tested with neovim-qt.

Fonts

The GUI font is Fira Code Nerd Font, and vim-airline is set to use Powerline fonts.

GitHub Issues

To use GitHub issues integration with private repositories, create ~/.config/github/tokens/github-issues.vim containing a GitHub personal access token.

Packages

• curl for downloading unicode data.
• ripgrep or 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).

Installation

Automatic Install

You can install this via the command-line with either curl

$ curl -L https://rc.evansosenko.com/nvimrc/install.sh | sh

or wget

$ wget https://rc.evansosenko.com/nvimrc/install.sh -O - | sh

To install into an isolated Neovim app, set NVIM_APPNAME first:

$ NVIM_APPNAME=nvimrc curl -L https://rc.evansosenko.com/nvimrc/install.sh | sh

Manual Install

1. Install vim-plug.

2. Create init.vim in the active config directory (~/.config/nvim by default, or ~/.config/<appname> when NVIM_APPNAME is set):

   " rxrc/nvimrc
   
   let s:config_root = stdpath('config')
   
   call plug#begin(s:config_root . '/plugged')
   
   if filereadable(s:config_root . '/plugged/nvimrc/plugins.vim')
     execute 'source ' . fnameescape(s:config_root . '/plugged/nvimrc/plugins.vim')
     Plug 'rxrc/nvimrc'
   else
     Plug 'rxrc/nvimrc', { 'on': [] }
   endif
   
   call plug#end()

   and ginit.vim in the same directory:

   " rxrc/nvimrc
   
   execute 'source ' . fnameescape(stdpath('config') . '/plugged/nvimrc/gui.vim')

3. Run

   $ nvim -c PlugInstall
   

   To use an isolated app, run the same commands with NVIM_APPNAME=nvimrc.

Updating

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.
nvimupg () {
  local config_home=${XDG_CONFIG_HOME:-$HOME/.config}
  local app_name=${NVIM_APPNAME:-nvim}

  if ! [[ -e ${config_home}/${app_name}/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!
}

With NVIM_APPNAME=nvimrc, the same flow uses ~/.config/nvimrc and the matching cache directories instead of the default nvim paths.

Development and Testing

Source Code

The nvimrc source is hosted on GitHub. Clone the project with

$ git clone https://github.com/rxrc/nvimrc.git

Local Development Mode

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

Contributing

Please submit and comment on bug reports and feature requests.

To submit a patch:

1. Fork it (https://github.com/rxrc/nvimrc/fork).
2. Create your feature branch (git checkout -b my-new-feature).
3. Make changes.
4. Commit your changes (git commit -am 'Add some feature').
5. 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.

License

This Neovim config is licensed under the MIT license.

Warranty

This software is provided by the copyright holders and contributors "as is" and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the copyright holder or contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.