Repository files navigation

Vim Bootstrap provides a simple method for generating .vimrc configuration files for Vim, NeoVim, NeoVim-Qt, MacVim and GVim.

Want to generate your vim/neovim file? Accesshere!

The distribution is designed to work with Vim >= 8 and neovim.

$ brew install git ctags

• Ubuntu\Debian

$ sudo apt-get install git exuberant-ctags ncurses-term curl

• Gentoo

$ sudo emerge --ask dev-util/ctags sys-libs/ncurses dev-vcs/git dev-python/pyflakes net-misc/curl

• Arch Linux viapacman

$ sudo pacman -S git ctags ncurses curl

• Fedora

$ sudo dnf install ncurses-devel git ctags curl

• openSUSE

$ sudo zypper in ncurses-devel git ctags curl

• FreeBSD viapackages collection

# pkg install git p5-Parse-ExuberantCTags ncurses curl

• pyflakes
• jedi
• neovim (neovim only)

$ pip install flake8 jedi$ pip2 install --user --upgrade neovim$ pip3 install --user --upgrade neovim

• elm-test
• elm-oracle
• elm-format

$ npm install -g elm-test$ npm install -g elm-oracle$ npm install -g elm-format@exp

• rls

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

• Download your own vimrc file athttps://vim-bootstrap.com
• Put your vimrc file into home folder or$XDG_CONFIG_HOME/nvim/init.vim if you use NeoVim

vim:mv ~/Downloads/generate.vim ~/.vimrc

neovim:mv ~/Downloads/generate.vim $XDG_CONFIG_HOME/nvim/init.vim

• Execute ViM and it will install plugins automatically

vim

Vim-bootstrap generator can accept URL params via request as example below.

curl 'https://vim-bootstrap.com/generate.vim' --data 'editor=vim&frameworks=vuejs&langs=javascript&langs=php&langs=html&langs=ruby' > ~/.vimrc

:VimBootstrapUpdate (thanks to @sherzberg):PlugInstall

You can run vim-bootstrap Go package to generate a vimrc file, just download it:

go get github.com/editor-bootstrap/vim-bootstrapcd $GOPATH/src/github.com/editor-bootstrap/vim-bootstrapgo build

Inside vim-bootstrap foldercd vim-bootstrap usevim-bootstrap module (file) like this example:

./vim-bootstrap -langs=python,lua,ruby,javascript,haskell -frameworks vuejs -editor=vim > ~/.vimrc

For more instructions runvim-bootstrap -h

vim-bootstrap is also available on openSUSE on both Leap 42.2/42.3 and Tumbleweed. Leap versions must add devel:tools repository before, while Tumbleweed users should have vim-bootstrap in the default repository without the need to add any extra repository.

• Leap 42.2

$ sudo zypper ar -f http://download.opensuse.org/repositories/devel:/tools/openSUSE_Leap_42.2/ devel:tools$ sudo zypper ref$ sudo zypper in vim-bootstrap

• Leap 42.3

$ sudo zypper ar -f http://download.opensuse.org/repositories/devel:/tools/openSUSE_Leap_42.3/ devel:tools$ sudo zypper ref$ sudo zypper in vim-bootstrap

• Tumbleweed

$ sudo zypper ref$ sudo zypper in vim-bootstrap

Create a folder insidegenerate/vim_template/themes/ with the name of your theme.

mkdir generate/vim_template/themes/my_theme

Inside this folder, add a file calledmytheme.vim with colorscheme instruction (optionally other configs).

echo "colorscheme mytheme" > generate/vim_template/themes/my_theme/mytheme.vim

Add a.bundle extension file with instructions of how to install theme.

echo "Plug username/mytheme" > generate/vim_template/themes/my_theme/mytheme.vim.bundle

Submit a PR and when approved new theme was added.

It's highly recommended to add customizations in a separate file. This way, you can maintain the original vim-bootstrap generated vimrc file and subsequent updates.

For Vim users, the files available for customization are~/.vimrc.local and~/.vimrc.local.bundles. The former handles general configuration while the latter handles external Vim plugins throughvim-plug.

NeoVim users can also customize their configuration by using$XDG_CONFIG_HOME/nvim/local_init.vim and$XDG_CONFIG_HOME/nvim/local_bundles.vim.

Visit the following sites to learn more about Vim:

• Learn Vim Progressively
• Vim Adventures
• Vimcasts
• Byte of Vim
• MinuteVim Tricks
• Join the Church of Vim, and you too can be a saint!
• Vim para noobs (in portuguese)
• Vimbook (in portuguese)