vim-bracketed-paste/README.md
Denilson Figueiredo de Sá dd82b5746a Improving README.md
Added more details about how it works (based on `$TERM` variable and only works on *insert mode*). Closes #7.
2014-07-10 15:58:55 -03:00

26 lines
1.3 KiB
Markdown

vim-bracketed-paste enables transparent pasting into vim. (i.e. no more `:set paste!`)
Installation
============
I recommend using [pathogen](https://github.com/tpope/pathogen). Once you have installed pathogen:
```bash
cd ~/.vim/bundle
git clone https://github.com/ConradIrwin/vim-bracketed-paste
```
Otherwise just copy-paste everything from [plugin/bracketed-paste.vim](https://github.com/ConradIrwin/vim-bracketed-paste/blob/master/plugin/bracketed-paste.vim) into your `~/.vimrc`.
Usage
=====
You need to be using a modern xterm-compatible terminal emulator that supports [bracketed paste mode](http://cirw.in/blog/bracketed-paste). xterm, urxvt, iTerm2, gnome-terminal (and other terminals using libvte) are known to work, just make sure `$TERM` variable is set correctly. If your `$TERM` value is not recognized by the plugin, please send a pull request.
Then whenever you are in the *insert mode* and paste into your terminal emulator using `command+v`, `shift+insert`, `ctrl+shift+v` or `middle-click`, vim will automatically `:set paste` for you.
Credit
======
The code for this plugin was taken from Chis Page's answer to a [StackOverflow question](http://stackoverflow.com/questions/5585129/pasting-code-into-terminal-window-into-vim-on-mac-os-x), I just packaged it.