Give Up GitHub

This project has given up GitHub. (See Software Freedom Conservancy's Give Up GitHub site for details.)

You can now find this project at SourceHut instead.

Any use of this project's code by GitHub Copilot, past or present, is done without our permission. We do not consent to GitHub's use of this project's code in Copilot.

Join us; you can give up GitHub too!

vimrc

This is my personal VIM configuration repository.

Copyright (C) 2011-2023 By Devin Weaver suki (at) tritarget.org

Features

This seamlessly uses either Vundle or Pathogen to manage plugins (or bundles) It is also compataible with vim-update-bundles.

The files are dotty compatible but there is also an easy install.sh script (see below).

Layout

scripts/

A directory of helper and misclanious scripts that are not part of VIM or the VIM config files. (Not needed for a simple vimrc install).

dotty-repository.thor

Runs install.sh after dotty bootstrap.

dotty-symlinks.yml

Tells Dotty how to symlink the following files / directories.

vimrc / gvimrc

The main .vimrc and .gvimrc. They are linked to ~/.vimrc and ~/.gvimrc (_vimrc and _gvimrc on windows)

vimfiles/

All the custom config scripts. Links to ~/.vim

install.sh

A shell script to manually make the symlinks and also download a plugin manager.

Usage: install.sh [-M][-I][-f][-w][-p][-v][-b] [-d prefix]
  -M,--no-managers          Do not download and install plugin managers
  -I,--no-install           Do not install .vimrc, .gvimrc and .vim
  -w,--windows              Use windows paths (_vimrc, _gvimrc, vimfiles)
  -f,--force                Force overwriting vimrc, gvimrc, etc. ** DESTRUCTIVE **
  -p,--pathogen             Install pathogen package
  -b,--vim-upadate-bundles  Install vim-update-bundles package
  -v,--vundle               Install vundle package even if -p was used
  -h,--help                 This cruft
  -d,--dir prefix           Install to prefix instead of default $HOME/.vim
Cannot concatinate arguments (-IM will not work, use -I -M instead).

Installation / usage

Instalation is handled either via a dotfile management system (like Dotty) or manually via the install.sh file.

Once the symlinks (or copied files) are in place all bundles can be installed with a plugin manager such as Vundle or vim-update-bundles (which will download and install the bundles listed in vimrc.

Vundle will automatically load the bundles into vim when it starts. However vim-update-bundles will need Pathogen to load the bundles.

the vimrc will automatically use the above managers if found or ignore them if not.

Requirements

Vundle

• git (the git executable must be in your $PATH)

vim-update-bundles

• ruby (tested on 1.9.2) and rubygems
• git (the git executable must be in your $PATH)

install.sh

• Either git or curl in your $PATH

License

This work is licensed under a Creative Commons Attribution 3.0 Unported License.

With the express exception of the install.sh file which is licensed under the GNU General Public License V3.0 or later.