diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3bfe733
--- /dev/null
+++ b/README.md
@@ -0,0 +1,32 @@
+# Vim-RNB, a Vim colorscheme template
+
+## What is this thing?
+
+RNB is a template designed to help vimmers create their own colorschemes without much effort.
+
+## How do I use it?
+
+The process is divided in four steps:
+
+1. start by editing your colorscheme's information,
+2. define your colors,
+3. define your highlight groups and links,
+4. and generate your colorscheme.
+
+Each step is throughly described in the colorscheme template: `src/rnb.erb`.
+
+## How does it work?
+
+The templates in this repository use ERB, Ruby's built-in templating system, so you will need a working Ruby installation to generate your colorscheme. Ruby knowledge is not needed at all, though.
+
+This repository contains two templates: `src/rnb.erb`, the colorscheme template, and `src/readme.erb`, the README template.
+
+### The colorscheme template
+
+The template is split into two sections of which only the first is of interest to the casual user.
+
+#### First section: the settings
+
+#### Second section: the template
+
+### The README template
diff --git a/README.txt b/README.txt
deleted file mode 100644
index 7b603c6..0000000
--- a/README.txt
+++ /dev/null
@@ -1 +0,0 @@
-RNB
diff --git a/colors/rnb.vim b/colors/rnb.vim
deleted file mode 100644
index faea161..0000000
--- a/colors/rnb.vim
+++ /dev/null
@@ -1,167 +0,0 @@
-" rnb.vim -- Vim color scheme.
-" Author:      foo (foo@foo.foo)
-" Webpage:     http://www.example.com
-" Description: Lorem ipsum dolor sit amet.
-
-hi clear
-
-if exists("syntax_on")
-  syntax reset
-endif
-
-let colors_name = "rnb"
-
-if ($TERM =~ '256' || &t_Co >= 256) || has("gui_running")
-    hi Normal ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-
-    set background=light
-
-    hi NonText ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Comment ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Constant ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Error ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Identifier ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Ignore ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi PreProc ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Special ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Statement ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi String ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Todo ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Type ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Underlined ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi StatusLine ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi StatusLineNC ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi VertSplit ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi TabLine ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi TabLineFill ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi TabLineSel ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Title ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi CursorLine ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi LineNr ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi CursorLineNr ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi helpLeadBlank ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi helpNormal ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Visual ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi VisualNOS ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Pmenu ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi PmenuSbar ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi PmenuSel ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi PmenuThumb ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi FoldColumn ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Folded ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi WildMenu ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi SpecialKey ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi DiffAdd ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi DiffChange ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi DiffDelete ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi DiffText ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi IncSearch ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Search ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Directory ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi MatchParen ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi SpellBad ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE guisp=#ff0000
-    hi SpellCap ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE guisp=#0000ff
-    hi SpellLocal ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE guisp=#ff00ff
-    hi SpellRare ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE guisp=#00ffff
-    hi ColorColumn ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi SignColumn ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi ErrorMsg ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi ModeMsg ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi MoreMsg ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Question ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi Cursor ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi CursorColumn ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi QuickFixLine ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi StatusLineTerm ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-    hi StatusLineTermNC ctermbg=15 ctermfg=8 cterm=NONE guibg=#ffffff guifg=#808080 gui=NONE
-
-elseif &t_Co == 8 || $TERM !~# '^linux' || &t_Co == 16
-    set t_Co=16
-
-    hi Normal ctermbg=white ctermfg=darkgray cterm=NONE
-
-    set background=light
-
-    hi NonText ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Comment ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Constant ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Error ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Identifier ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Ignore ctermbg=white ctermfg=darkgray cterm=NONE
-    hi PreProc ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Special ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Statement ctermbg=white ctermfg=darkgray cterm=NONE
-    hi String ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Todo ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Type ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Underlined ctermbg=white ctermfg=darkgray cterm=NONE
-    hi StatusLine ctermbg=white ctermfg=darkgray cterm=NONE
-    hi StatusLineNC ctermbg=white ctermfg=darkgray cterm=NONE
-    hi VertSplit ctermbg=white ctermfg=darkgray cterm=NONE
-    hi TabLine ctermbg=white ctermfg=darkgray cterm=NONE
-    hi TabLineFill ctermbg=white ctermfg=darkgray cterm=NONE
-    hi TabLineSel ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Title ctermbg=white ctermfg=darkgray cterm=NONE
-    hi CursorLine ctermbg=white ctermfg=darkgray cterm=NONE
-    hi LineNr ctermbg=white ctermfg=darkgray cterm=NONE
-    hi CursorLineNr ctermbg=white ctermfg=darkgray cterm=NONE
-    hi helpLeadBlank ctermbg=white ctermfg=darkgray cterm=NONE
-    hi helpNormal ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Visual ctermbg=white ctermfg=darkgray cterm=NONE
-    hi VisualNOS ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Pmenu ctermbg=white ctermfg=darkgray cterm=NONE
-    hi PmenuSbar ctermbg=white ctermfg=darkgray cterm=NONE
-    hi PmenuSel ctermbg=white ctermfg=darkgray cterm=NONE
-    hi PmenuThumb ctermbg=white ctermfg=darkgray cterm=NONE
-    hi FoldColumn ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Folded ctermbg=white ctermfg=darkgray cterm=NONE
-    hi WildMenu ctermbg=white ctermfg=darkgray cterm=NONE
-    hi SpecialKey ctermbg=white ctermfg=darkgray cterm=NONE
-    hi DiffAdd ctermbg=white ctermfg=darkgray cterm=NONE
-    hi DiffChange ctermbg=white ctermfg=darkgray cterm=NONE
-    hi DiffDelete ctermbg=white ctermfg=darkgray cterm=NONE
-    hi DiffText ctermbg=white ctermfg=darkgray cterm=NONE
-    hi IncSearch ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Search ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Directory ctermbg=white ctermfg=darkgray cterm=NONE
-    hi MatchParen ctermbg=white ctermfg=darkgray cterm=NONE
-    hi SpellBad ctermbg=white ctermfg=darkgray cterm=NONE
-    hi SpellCap ctermbg=white ctermfg=darkgray cterm=NONE
-    hi SpellLocal ctermbg=white ctermfg=darkgray cterm=NONE
-    hi SpellRare ctermbg=white ctermfg=darkgray cterm=NONE
-    hi ColorColumn ctermbg=white ctermfg=darkgray cterm=NONE
-    hi SignColumn ctermbg=white ctermfg=darkgray cterm=NONE
-    hi ErrorMsg ctermbg=white ctermfg=darkgray cterm=NONE
-    hi ModeMsg ctermbg=white ctermfg=darkgray cterm=NONE
-    hi MoreMsg ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Question ctermbg=white ctermfg=darkgray cterm=NONE
-    hi Cursor ctermbg=white ctermfg=darkgray cterm=NONE
-    hi CursorColumn ctermbg=white ctermfg=darkgray cterm=NONE
-    hi QuickFixLine ctermbg=white ctermfg=darkgray cterm=NONE
-    hi StatusLineTerm ctermbg=white ctermfg=darkgray cterm=NONE
-    hi StatusLineTermNC ctermbg=white ctermfg=darkgray cterm=NONE
-endif
-
-hi link Number Constant
-hi link WarningMsg Error
-
-let g:terminal_ansi_colors = [
-        \ '#000000',
-        \ '#800000',
-        \ '#008000',
-        \ '#808000',
-        \ '#000080',
-        \ '#800080',
-        \ '#008080',
-        \ '#c0c0c0',
-        \ '#808080',
-        \ '#ff0000',
-        \ '#00ff00',
-        \ '#ffff00',
-        \ '#0000ff',
-        \ '#ff00ff',
-        \ '#00ffff',
-        \ '#ffffff',
-        \ ]
-
-" Generated with RNB (https://gist.github.com/romainl/5cd2f4ec222805f49eca)
diff --git a/README.tpl.md b/src/readme.erb
similarity index 100%
rename from README.tpl.md
rename to src/readme.erb
diff --git a/colors/rnb.erb b/src/rnb.erb
similarity index 100%
rename from colors/rnb.erb
rename to src/rnb.erb