https://github.com/samuelsimoes/vim-drawer
VimDrawer is a Vim plugin to group related buffers in tabs automatically by the file name.
https://github.com/samuelsimoes/vim-drawer
productivity vim vim-plugins workflow
Last synced: 9 months ago
JSON representation
VimDrawer is a Vim plugin to group related buffers in tabs automatically by the file name.
- Host: GitHub
- URL: https://github.com/samuelsimoes/vim-drawer
- Owner: samuelsimoes
- Created: 2016-06-12T00:41:58.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2018-01-17T20:59:57.000Z (over 8 years ago)
- Last Synced: 2025-04-13T14:38:08.379Z (about 1 year ago)
- Topics: productivity, vim, vim-plugins, workflow
- Language: Vim script
- Homepage:
- Size: 310 KB
- Stars: 26
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# VimDrawer
:point_right: When you work with some big tasks you may need edit too many files at once and most of the time you may get lost in so many files.
VimDrawer is a Vim plugin to help you to work with many open files on Vim in a sane way.
## Usage
First, you must be familiar with [Vim buffers](http://joshldavis.com/2014/04/05/vim-tab-madness-buffers-vs-tabs/), if you are, the basic idea is to create **scoped buffer lists per tab** AND do a **file auto classification** to send your file to the correct tab based on the file name. For now on I will call this tabs as "drawer".
To use you must define the schema of your drawers using an array on the global variable `g:vim_drawer_spaces` on your vimfiles. The array's first position is the _drawer name_ and the second is the **RegExp to match the file name if it should or not go to the drawer**. Example:
```viml
" ~/.vimrc
let g:vim_drawer_spaces = [
\["model", "model"],
\["controller", "controller"],
\["view", "\.html\.erb$"],
\["asset", "\.[js|css]$"]
\]
```
In the example above every file that has `model` in the name goes to the tab named as **model**, your _models drawer_.
Any other file that hasn't the declared drawer destination goes to the current drawer.
:bulb: You can define drawers schema per project by adding in your project's root the `.vim-drawer.vim` file, on this file you must set the `g:vim_drawer_spaces` array.
To check what files are in the drawer you will need to invoke the command `:VimDrawer`. This command will open a horizontal split with a list of the current buffers in the drawer. To open the buffer just press `enter`. To close a buffer right on the selector just press `c`. To just preview a buffer without leave the drawer press `space`.
:bulb: You can map this command to a shortcut like:
```viml
nnoremap :VimDrawer
```
Now you can invoke the drawer's buffers selector pressing `Ctrl + Space`.
## Installation
You can install this plugin with Pathogen, Vundle and other plugin loaders.
## Is it a [vim-ctrl-space](https://github.com/vim-ctrlspace) copycat?
This plugin is a simplified version of the awesome vim-ctrl-space plugin with the auto file classification feature (that I even had [shown to vim-ctrlspace folks](https://github.com/vim-ctrlspace/vim-ctrlspace/issues/177)). I decide to create a separate version mainly to implement the auto classification feature and because vim-ctrl-space IMHO could be much more simple at some aspects that I won't discourse here. Ping me on Twitter if you are interested.
-------
Samuel Simões ~ [@samuelsimoes](https://twitter.com/samuelsimoes) ~ [Blog](http://blog.samuelsimoes.com/)