36 lines
1.4 KiB
Markdown
36 lines
1.4 KiB
Markdown
# 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.
|
|
|
|
In reality, Vim colorschemes are not that hard to write but there are several benefits to using a template such as RNB:
|
|
|
|
* you can define/modify variables once instead of messing around with potentially botched substitutions,
|
|
* you can distribute a lean colorscheme, free from unnecessary logic,
|
|
* you can distribute the source alongside the colorscheme, making it easy for your users to experiment and adapt *your* colorschemes to *their* needs,
|
|
* you can focus on the design of your colorscheme rather than its implementation,
|
|
* you can start working on new colorscheme ideas very easily.
|
|
|
|
## What do I need to use it?
|
|
|
|
[ERB](https://ruby-doc.org/stdlib-2.6.3/libdoc/erb/rdoc/index.html), the templating engine used here, is part of Ruby's standard library so you will need [Ruby](https://www.ruby-lang.org/) to generate your colorscheme. Neither ERB nor Ruby knowledge is required, though.
|
|
|
|
## 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 thoroughly described in the colorscheme template: `src/rnb.erb`.
|
|
|
|
## TODO
|
|
|
|
* `README.md` template
|
|
|
|
|
|
[//]: # ( Vim: set spell spelllang=en: )
|