rc

" Some details on the contents:

" This file is my personal Vim configuration file. It contains my plugins, is

" divided to subject, and fattened with lovely comments.

" Please be advised that some (obvious) settings are left out, because I

" actually only use NeoVim. Again, this is my PERSONAL file, not a 'general

" public Vi(m) compatible' file.

" VUNDLE {{{

" Vundle is used to manage plugins for Vim. It needs additional setup, so it

" gets priority in my .vimrc.

filetype off                  " required

" set the runtime path to include Vundle and initialize

set rtp+=~/.vim/bundle/Vundle.vim

call vundle#begin()

" let Vundle manage Vundle, required

Plugin 'VundleVim/Vundle.vim'

" YCM is a plugin that allows Vim semantic type checking and more programming mumbo jumbo. It is godlike and it must always be there for me.

Plugin 'Valloric/YouCompleteMe'

" Java is a holy language, and because of its holiness, it requires an onslaught

" of bloat software on your PC to even get a bit of semantic autocompletion.

" I've found a project which (at least) works without having to install Eclipse,

" Eclim, and whatever else you need. This is that tool.

Plugin 'artur-shaik/vim-javacomplete2'

" Neomake replaces Syntastic from now on. It's an asynchronous linter, so yeah,

" pretty cool and must-have.

Plugin 'neomake/neomake'

" Airline provides a neat and feature rich status bar. Really nice to have.

Plugin 'bling/vim-airline'

" Bufferline will show buffers in the status bar. There's enough room anyway, so I fancied having it.

Plugin 'bling/vim-bufferline'

" A fuzzy searcher. Just CTRL+P and BAM all your files are visible.

Plugin 'kien/ctrlp.vim'

" This is a plugin for Git interaction. It places added and removed line icons

" in the 'gutter' (the bar next to the line numbering). It's better than

" Fugitive, because not only does it provide something you don't have with it

" (visible change lines), Fugitive offers functionality I rarely use (Git

" commands from Vim, which I ALWAYS do in the standard TUI), and it has

" provisions for NeoVim's asynchronous abilities.

Plugin 'airblade/vim-gitgutter'

" This provides snippets for redundant code. Praise the hackers man.

Plugin 'SirVer/ultisnips'

" In addition to UltiSnips, this plugin contains a prefetched repository of snippets. Must have, because I'm not planning on writing all of those by myself.

Plugin 'honza/vim-snippets'

" Rust syntax files, including Syntastic integration:

" To be removed when these are added to (Neo)Vim 'upstream'.

Plugin 'rust-lang/rust.vim'

" All of your Plugins must be added before the following line

call vundle#end()            " required

filetype plugin indent on    " required

" }}}

" YOUCOMPLETEME {{{

" YouCompleteMe is a godlike completer for Vim. As such, it is worthy of its own section.

" However, I'll be trying out Deoplete in the future, which might render it

" obsolete. Until further notice, I'm keeping this beauty.

"

" This setting will force YCM to close the preview buffer after selecting the completion.

let g:ycm_autoclose_preview_window_after_completion=1

" Sets the symbol used to indicate a syntax error:

let g:ycm_error_symbol = '>>'

" Sets the symbol used to indicate a warning:

let g:ycm_warning_symbol = 'i'

" Fills the identifier completion database with the language's keywords (e.g., when starting a new Java file, "class" will already be in the completion engine.

let g:ycm_seed_identifiers_with_syntax = 1

" This setting tells YCM what keys to use to accept completion. I removed <Down> as default, because I'm a silly coder and still use my arrow keys to navigate my source files. Hey, years of negligence for Vim leaves its marks. To think I ever thought Notepad++ was the best editor ever, the fuck...

let g:ycm_key_list_select_completion=['<TAB>']

" Same reason; I'm a dumb fuck and arrows are still hardwired in my brain.

let g:ycm_key_list_previous_completion=['<S-TAB>']

" Configures the pointer to the ycm_extra_conf.py file.

let g:ycm_global_ycm_extra_conf = '~/.ycm_extra_conf.py'

let g:ycm_confirm_extra_conf = 0 " Disables security confirmation before loading the conf.py file.

" Configuration necessary for sematic Rust completion

let g:ycm_rust_src_path = '/usr/src/rust/src'

" }}}

"

" JAVACOMPLETE {{{

" Refraining from having to use Eclim and all the junk that attaches itself to

" it, means I have to use something else. Vim-javacomplete2 is that thing, but

" it has some additional settings that need to be set, in order to use it

" properly.

"

" Required; tell Vim that there's a completer for Java files:

autocmd FileType java setlocal omnifunc=javacomplete#Complete

" Stops adding closing braces, which conflicts with my way of thinking, which

" is: If I didn't hit the key for it, why the fuck is it on my screen.

let g:JavaComplete_ClosingBrace = 0

" JavaComplete uses a cache, which I can totally understand, because Java. I've

" set it to something more reasonable:

let g:JavaComplete_BaseDir = '~/.vim/.javacomplete-cache'

"

" TODO: javacomplete2 has a list of "default keymappings" on its GitHub page.

" It's possible that I'll have to delete these later. If so, refer to 

" https://github.com/artur-shaik/vim-javacomplete2#required

" }}}

"

" NEOMAKE {{{

" This setting lets Neomake run on every file write:

autocmd! BufWritePost * Neomake

" }}}

"

" GITGUTTER {{{

" Disables all keymappings of GitGutter. I don't use them anyway.

let g:gitgutter_map_keys = 0

" Sets the 'refresh time' of when to update. Standard is 4 seconds.

set updatetime = 250

" necessary for more information.

" }}}

"

" AIRLINE {{{

" Airline is a great status bar plugin. Although it can behave quirky if Powerline is not on the scene. These scripts are dedicated to handle that behavior.

" These lines will load the powerline font for use in Airline.

if !exists('g:airline_symbols')

		let g:airline_symbols={}

	endif

let g:airline_symbols.space="\ua0"

let g:airline_powerline_fonts=1

" If there is only one tab opened, the tab bar will display the different buffers.

let g:airline#extensions#tabline#enabled=1

let g:bufferline_echo = 0 " Disables automatic echoing to the bufferline.

" }}}

" ULTISNIPS {{{

" As mentioned earlier, this provides snippets to stop redundant code.

" To begin, changing default TAB, because YCM already uses TAB.

	let g:UltiSnipsExpandTrigger="<c-l>"

	let g:UltiSnipsJumpForwardTrigger="<c-j>"

	let g:UltiSnipsJumpBackwardTrigger="<c-k>"

" }}} 

"

" COLOURS & COLORS {{{

colorscheme molokai " I like molokai. I've used badwolf, but I like popping colors.

" }}}

" SPACES & TABS {{{

" The number of visual spaces per TAB hit.

set tabstop=4

" Setting the amount of tabs to 4. The default is 8.

set shiftwidth=4

" This breaks lines after column 80.

set textwidth=80

" }}}

" UI CONFIGURATION {{{

" The next 2 settings enable relative line numbering, but retain the absolute

" line numbering for the line currently selected by the cursor.

set number

set relativenumber

set cursorline " Highlights the line currently selected by the cursor.

filetype indent on " Detects filetype on load, and loads the appropriate syntax file.

set showmatch " Highlights matching parenthesis on hover ("[, {, ...").

" scrolloff tells Vim how much lines above/below the cursor should always be

" visible. For example, if set to 5, there will always be 5 lines below and

" above the cursor, except when reaching the EOF.

set scrolloff=5

" Next setting disables outputting the current mode to the last line. I did so,

" because I use Airline, which already prints the current mode.

set noshowmode

" }}}

" SEARCHING {{{

" Problem with hlsearch is that it does not turn off the highlighting. So searching for vowels may quickly result in everything being highlighted. This is a mapping. It will remove highlighting when entering \<SPACE>

nnoremap <leader><space> :nohlsearch<CR>

" }}}

" FOLDING {{{

" In case I forget (I'm Belgian), folding is hiding code parts that belong together, like functions. Très important. Fuck azerty.

" This enables folding as is.

set foldenable

" This setting determines how many folds have to be opened. The number indicates the folding level. So 0 = every possible folding is folded. 99 = practically everything is open. I'm using 10, since I already have a problem with more than 3 nested loops.

set foldlevelstart=10

" This setting blocks overuse of nested foldings. I don't know how this will turn out in LISP/Scheme, but I'll be damned if this setting does more harm than good.

set foldnestmax=10

" This setting is commented by default, but included in case I start to grow hate for the current way Vim handles folding (za). It basically maps that command to spacebar. I may map it to z because then I only have to type one letter and RETURN, that's 33% of my time saved! =3

"nnoremap <space> za

" }}}

" MOVEMENT {{{

" Up and down moving in Vim using j/k defaults to "physical line movement", i.e.

" if a line is too long, it's wrapped to the next line ("virtual lines"), but

" the line counter still regards it as 1 line.

" The next setting makes it so that, if j/k is pressed once, it moves over

" virtual lines, but when repeated (say "5dd"), it moves over physical lines.

" Basically, the perfect tradeoff solution when using relative line numbering.

noremap <silent> <expr> j (v:count == 0 ? 'gj' : 'j')

noremap <silent> <expr> k (v:count == 0 ? 'gk' : 'k')

" Next 4 lines disable arrow keys.

noremap <Up> <nop>

noremap <Down> <nop>

noremap <Left> <nop>

noremap <Right> <nop>

" }}}

" BACKING UP {{{

" What these lines do, is move the backup files to the /tmp folder. This will keep my directories clean and neat.

set backup

set backupdir=~/.vim-tmp,~/.tmp,~/tmp,/var/tmp,/tmp

set backupskip=/tmp/*,/private/tmp/*

set directory=~/.vim-tmp,~/.tmp,~/tmp,/var/tmp,/tmp

set writebackup

" }}}

"

" NEOVIM {{{

" While it certainly is an improvement over 'vanilla' Vim, it does some things

" that keep me from using Vim as it's supposed to be; limited to no mouse usage.

" So I disable it. I'll enable it again when I've twisted my mind far enough to

" not touch my mouse again. (Not to mention some terminals don't support mouse

" control, so it's a bad habit nonetheless if you spend all your time on

" GNU/Linux distros)

set mouse=""

" }}}

"

" MACROS {{{

" Function that allows to quickly switch between relative and absolute numbering using

" CTRL+N(umber).

function! NumberToggle()

	if(&relativenumber == 1)

		set norelativenumber  " Necessary to disable the previous behavior.

		set number

	else

		set number " Retains absolute number on the current line.

		set relativenumber

	endif

endfunc

nnoremap <C-n> :call NumberToggle()<cr>

" }}}

" OTHER IMPORTANT STUFF {{{

" I found this gem on Reddit. If I'm editing a file that's read only, and I started Vim without sudo, then this little line will do just that for me. All I have to do is use "w!!" when saving.

" Extensive explanation can also be found at https://stackoverflow.com/questions/2600783/how-does-the-vim-write-with-sudo-trick-work#7078429

cmap w!! w !sudo tee > /dev/null %

" This setting will allow me to switch to another buffer without need to save the current buffer.

set hidden

" }}}

" Because Vim can fold vimrc files with the right syntax, These lines will tell Vim how to handle that.

set modelines=2 "This tells Vim that the last 2 lines of this file should only apply to this file.

" So as you can see, the last 2 lines get a special vim:-prefix, so Vim knows for sure this is what's important.

" To wrap a new section, look at the other sections, and copy that syntax.

" vim:foldmethod=marker

" vim:foldlevel=0