https://github.com/tpope/vim-vinegar
vinegar.vim: Combine with netrw to create a delicious salad dressing
https://github.com/tpope/vim-vinegar
Last synced: 10 months ago
JSON representation
vinegar.vim: Combine with netrw to create a delicious salad dressing
- Host: GitHub
- URL: https://github.com/tpope/vim-vinegar
- Owner: tpope
- Created: 2013-12-24T16:44:31.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2024-06-28T23:22:40.000Z (over 1 year ago)
- Last Synced: 2025-04-01T11:01:49.948Z (12 months ago)
- Language: Vim script
- Homepage: https://www.vim.org/scripts/script.php?script_id=5671
- Size: 37.1 KB
- Stars: 2,290
- Watchers: 22
- Forks: 88
- Open Issues: 32
-
Metadata Files:
- Readme: README.markdown
- Contributing: CONTRIBUTING.markdown
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
- awesome-vim - Vinegar
README
# vinegar.vim
> Split windows and the project drawer go together like oil and vinegar. I
> don't mean to say that you can combine them to create a delicious salad
> dressing. I mean that they don't mix well!
> - Drew Neil
You know what netrw is, right? The built in directory browser? Well,
vinegar.vim enhances netrw, partially in an attempt to mitigate the need for
more disruptive ["project drawer"][Oil and vinegar] style plugins.
[Oil and vinegar]: http://vimcasts.org/blog/2013/01/oil-and-vinegar-split-windows-and-project-drawer/
Some of the behaviors added by vinegar.vim would make excellent upstream
additions. Many, the author would probably reject. Others are a bit too wild
to even consider.
* Press `-` in any buffer to hop up to the directory listing and seek to the
file you just came from. Keep bouncing to go up, up, up. Having rapid
directory access available changes everything.
* All that annoying crap at the top is turned off, leaving you with nothing
but a list of files. This is surprisingly disorienting, but ultimately
very liberating. Press `I` to toggle until you adapt.
* The oddly C-biased default sort order is replaced with a sensible application
of `'suffixes'`.
* File hiding: files are not listed that match with one of the patterns in
`'wildignore'`.
If you put `let g:netrw_list_hide = '\(^\|\s\s\)\zs\.\S\+'`
in your vimrc, vinegar will initialize with dot files hidden.
Press `gh` to toggle dot file hiding.
* Press `.` on a file to pre-populate it at the end of a `:` command line.
This is great, for example, to quickly initiate a `:grep` of the file or
directory under the cursor. Type `.!chmod +x` and
get `:!chmod +x path/to/file`.
* Press `y.` to yank an absolute path for the file under the cursor.
* Press `~` to go home.
* Use Vim's built-in `CTRL-^` (`CTRL-6`) for switching back to the previous
buffer from the netrw buffer.
## Installation
Install using your favourite package manager, or use Vim's built-in package support:
mkdir -p ~/.vim/pack/tpope/start
cd ~/.vim/pack/tpope/start
git clone https://github.com/tpope/vim-vinegar.git
## Promotion
Like vinegar.vim? Star the repository on
[GitHub](https://github.com/tpope/vim-vinegar) and vote for it on
[vim.org](https://www.vim.org/scripts/script.php?script_id=5671).
Love vinegar.vim? Follow [tpope](http://tpo.pe/) on
[GitHub](https://github.com/tpope) and
[Twitter](http://twitter.com/tpope).
## License
Copyright © Tim Pope. Distributed under the same terms as Vim itself.
See `:help license`.