Files
vim-colors-pencil/README.markdown
2014-02-03 00:38:09 -07:00

106 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# vim-colors-pencil
> A light (and dark) color scheme for Vim inspired by iA Writer
![markdown-example](screenshots/markdown-example2.png)
## Features
iA Writer is an elegant word processor, marred only by its lack of Vim. It
does have a nice color scheme, however.
* Accurate colors
* Subtle indicators of changes in the gutter for Signify, git-gutter, etc.
* Use for both code and prose, though its definitely geared towards the
latter
* Light and dark variants
* iTerm color scheme [available][it] for using this color scheme with terminal-based Vim
## Requirements
Currently requires vim >= 7.0
## Installation
Install using Pathogen, Vundle, Neobundle, or your favorite Vim package
manager.
Or simply copy the color scheme file to your `~/.vim/colors` directory.
## Usage
Just like any other color scheme:
```vim
:colorscheme pencil
```
You can toggle between the light and dark variants:
```vim
:set background=dark
:set background=light
```
## Differences
Most notably, the # heading text is shaded blue. This compensates for
the lack of a visual cue found in iA Writer where the heading indicators
are inside the left margin. Here we use color instead.
## Font choices
iA Writer uses a typeface called Nitti Light by Blue Monday. ($)
Free alternatives with **bold** and _italic_ support include:
* [Anonymous Pro](https://www.google.com/fonts/specimen/Anonymous+Pro) (serif)
* [Courier Prime](http://quoteunquoteapps.com/courierprime/) (serif)
* [Cousine](http://www.google.com/fonts/specimen/Cousine)
* [DejaVu Sans Mono](http://dejavu-fonts.org/wiki/Download)
* [Liberation](https://fedorahosted.org/liberation-fonts/)
* [Luxi Mono Regular](http://www.fontsquirrel.com/fonts/Luxi-Mono) (serif)
* [Ubuntu Mono](https://www.google.com/fonts/specimen/Ubuntu+Mono)
Cousine is a good match for Nitti Light.
## See also
* [mattly/iterm-colors-pencil][it] - iTerm support for terminal-based use of the pencil color scheme
* [pencil color scheme at vim.org][vo]
[it]: https://github.com/mattly/iterm-colors-pencil
[vo]: http://www.vim.org/scripts/script.php?script_id=4850
If you find this plugin useful, you may want to check out these others by
[@reedes][re]:
* [vim-lexical][lx] - building on Vims spell-check and thesaurus/dictionary completion
* [vim-litecorrect][lc] - lightweight auto-correction for Vim
* [vim-pencil][pn] - rethinking Vim as a tool for writers
* [vim-quotable][qu] - extends Vim to support typographic (curly) quotes
* [vim-textobj-sentence][ts] - improving on Vim's native sentence motion command
* [vim-thematic][th] — modify Vims appearance to suit your task and environment
* [vim-wheel][wh] - screen-anchored cursor movement for Vim
* [vim-wordy][wo] - uncovering usage problems in writing
[re]: https://github.com/reedes
[lx]: http://github.com/reedes/vim-lexical
[lc]: http://github.com/reedes/vim-litecorrect
[pn]: http://github.com/reedes/vim-pencil
[qu]: http://github.com/reedes/vim-quotable
[ts]: http://github.com/reedes/vim-textobj-sentence
[th]: http://github.com/reedes/vim-thematic
[wh]: http://github.com/reedes/vim-wheel
[wo]: http://github.com/reedes/vim-wordy
The [README](https://github.com/reedes/vim-thematic) in
_thematic_ has more details on setting up emulation of iA Writer.
## Future development
If youve spotted a problem or have an idea on improving this color
scheme, please post it to the github project issue page.
<!-- vim: set tw=74 :-->