git.m455.casa

calm.vim

clone url: git://git.m455.casa/calm.vim

README.md

calm.vim

A pink, calm, and focused vim colorscheme.

Heavily influenced by vim-sunbather. I loved vim-sunbather, but I wanted to modify it quite a bit, and I found the source too complicated for me, so I ended up forking it, and then I ended up writing a new theme from scratch.

Screenshot

Installing calm.vim

This section describes how to install the calm colorscheme using one of the following methods:

• vim-plug
• the install.sh script
• a manual installation

Using vim-plug

1. Add the following line to your ~/.vimrc:

   Plug 'git://git.m455.casa/calm.vim'
   

2. Restart Vim.

3. In Vim, run :PlugInstall.

4. Add the following line to your ~/.vimrc:

   colorscheme calm
   

Using the install.sh script

1. Run git clone git://git.m455.casa/calm.vim

2. Run cd calm.vim

3. Run ./install.sh

4. Add the following line to your ~/.vimrc:

   colorscheme calm
   

Installing manually

1. Run git clone git://git.m455.casa/calm.vim

2. Run mkdir -p "$HOME/.vim/colors"

3. Run ln -sf calm.vim/colors/calm.vim "$HOME/.vim/colors/"

4. Add the following line to your "$HOME/.vimrc":

   colorscheme calm
   

Note: This creates a symlink from this git repository to ~/.vim/colors, so you can run git pull && ./install.sh when you want retrieve updates for this colorscheme.

Customizing calm.vim

This theme provides global, customizable variables for changing the foreground colors of syntax keywords.

This section contains the following sections:

• Syntax for customizing calm.vim
• Customizable variables
• Example customizations

Syntax for customizing calm.vim

You an customize this theme's variables by adding one or more of the customizable variables before your colorscheme declaration in your ~/.vimrc:

let <variable name> = '<your_color>'
let <variable name> = '<your_color>'
...
colorscheme calm

For example, to change the main color from pink to orange, add the following to your ~/.vimrc:

let g:main_color = '208'
colorscheme calm

Refer to Customizable variables for a full list of variables you can customize.

Customizing elements

For a full list of variables and what interface elements they color, refer to the following list:

• g:main_color:
• main colored text that stands out:
  • strings
  • numbers and floats
  • literals
  • booleans
  • lisp keywords
  • H1s in html
  • Markdown links
  • Markdown code
  • Markdown codeblocks
  • spelling highlights
• g:subtle_color:
• things that occur often, but could be noisy if you have a brain like me:
  • functions
  • conditionals
  • operators
  • types
  • structs
  • scheme quoted data
  • clojure macros
• g:non_code_color: comments and line numbers
• g:ui_very_dark_color: color of text width indicator
• g:ui_dark_color:
• background color of status bar at the bottom
• horizontally-split borders
• g:cyber_green:
• matched parentheses
• highlighted text
• g:highlighted_text_bg_color: highlighted text
• g:matched_parentheses_bg_color: matched parentheses, braces, brackets, angled brackets

Notes:

• To enable the status bar, type :set laststatus=2. For more information, type :help laststatus.
• To enable the text width indicator, type :set colorcolumn=+1. For more information, type :help colorcolumn. If you don't see a vertical line that displays the maximum width text should wrap at, then you can type :set textwidth=N, where you must replace N with the maximum lenght of characters you want vim to wrap text at.
• Spelling highlights do not display unless you type :set spell.

Example customizations

Purple and green theme:

let g:main_color = '49'
let g:subtle_color = '171'
colorscheme calm

Red and green theme:

let g:main_color = '49'
let g:subtle_color = '197'
colorscheme calm

Orange theme:

let g:main_color = '208'
colorscheme calm