mirror of
https://github.com/prurigro/darkcloud-vimconfig.git
synced 2024-12-22 08:40:24 -05:00
A Vim distribution with sane, modern defaults, a custom theme, and a collection of tightly integrated and configured development-oriented plugins
vim | ||
.gitmodules | ||
README.md | ||
vimrc |
Darkcloud Vim Theme, Config and Plugin Selection
Requirements
- Git and Bash: Required to manage plugin updates using the "pathogen_update_plugins" script.
- CTags: Available @ http://ctags.sourceforge.net, this can be in $PATH or in the vim folder and is required for the tagbar plugin.
- Vim v7.4+: Everything has been written and tested using Vim 7.4.135, and I assume there could be issues with 7.3 and below.
- Powerline Fonts (optional): Required for the powerline lightline theme, which can be toggled in /etc/vimrc along with the gVim font
Installation/Setup
- Clone this repository then initialize and update the git submodules (in our case, the vim plugins)
- ]$ git clone https://github.com/prurigro/darkcloud-vimconfig.git
- ]$ cd darkcloud-vimconfig
- ]$ git submodule init
- ]$ git submodule update
- Edit the 'vimrc' file and select whether to expect powerline fonts, choose a font for gVim, and add or change any of the loaded config files to match your personal setup.
- There are two main ways this package can be deployed: system-wide or single-user.
- For a distro-agnostic system-wide installation in the /etc directory, copy or link: 'vimrc' to '/etc/vimrc' -and- the 'vim' folder to '/etc/vim'.
- For a single-user installation in a user's home directory, copy or link: 'vimrc' to '
/.vimrc' -and- the 'vim' folder to '/.vim'.
- Make sure the 'vimrc' file and 'vim' folder are at least readable to any users that will be using the config.
- Clone additional vim plugin repos in the 'bundle' folder to have them loaded at startup.
- Yyou can add or replace config files in your 'vimrc' file to customize behaviour.
- Run the pathogen_update_plugins script to update your plugins by running 'git pull' on each folder with a '.git' directory in the bundle folder.
- The 'vim/config/keyboard.vim' file has a list of the commands it configures, as well as some basic examples of some provided directly by plugins (though check the plugin folder's README for a full explanation).
Credits
- Written by prurigro: Github Projects | Archlinux AUR Packages
- Many other authors have their work contained in this repo, most of which are self contained in the vim/bundle directory. I also used the Vim jellybean theme as a basis for the Darkcloud theme, which is maintained by NanoTech http://nanotech.nanotechcorp.net/
License
All projects cloned in the vim/bundle folder are separate and have their own licenses. Everything else is released under the MIT license.