https://github.com/tandrewnichols/vim-headfirst
Edit sibling files like a boss
https://github.com/tandrewnichols/vim-headfirst
vim vim-plugin
Last synced: 11 months ago
JSON representation
Edit sibling files like a boss
- Host: GitHub
- URL: https://github.com/tandrewnichols/vim-headfirst
- Owner: tandrewnichols
- License: mit
- Created: 2018-09-27T15:11:16.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-03-16T22:17:24.000Z (over 1 year ago)
- Last Synced: 2025-04-04T18:11:16.398Z (about 1 year ago)
- Topics: vim, vim-plugin
- Language: Vim Script
- Homepage:
- Size: 7.81 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Vim-Headfirst
Commands to quickly open sibling files in vim.
## Overview
This plugin is a small wrapper around `:e`, `:sp`, `:vsp`, and `:tabe` for editing sibling files. That is, it's comparable to typing `:e %:h/`, but it also let's you supply multiple files to open.
## Installation
If you don't have a preferred installation method, I really like vim-plug and recommend it.
#### Manual
Clone this repository and copy the files in plugin/, autoload/, and doc/ to their respective directories in your vimfiles, or copy the text from the github repository into new files in those directories. Make sure to run `:helptags`.
#### Plug (https://github.com/junegunn/vim-plug)
Add the following to your vimrc, or something sourced therein:
```vim
Plug 'tandrewnichols/vim-headfirst'
```
Then install via `:PlugInstall`
#### Vundle (https://github.com/gmarik/Vundle.vim)
Add the following to your vimrc, or something sourced therein:
```vim
Plugin 'tandrewnichols/vim-headfirst'
```
Then install via `:BundleInstall`
#### NeoBundle (https://github.com/Shougo/neobundle.vim)
Add the following to your vimrc, or something sourced therein:
```vim
NeoBundle 'tandrewnichols/vim-headfirst'
```
Then install via `:BundleInstall`
#### Pathogen (https://github.com/tpope/vim-pathogen)
```sh
git clone https://github.com/tandrewnichols/vim-headfirst.git ~/.vim/bundle/vim-headfirst
```
## Usage
Using the following commands to edit sibling files in the corresponding windows. Tab completion works as normal.
### :He/:Hedit
Edit a sibling file in the current window.
```vim
:He foo.js
```
### :Hsp/:Hsplit
Edit a sibling file in a split.
```vim
" All these commands accept multiple sibling files, although it may not make sense to ":edit"
" multiple files at the same time. It's basically like preloading the additional ones.
:Hsp foo.js bar.js
```
### :Hvsp/:Hvsplit
Edit a sibling file in a vertical split.
```vim
:Hvsp foo.js
```
### :Htabe/:Htabedit
Edit a sibling file in a new tab.
```vim
:Htabe foo.js bar.js baz.js
```
## Contributing
I always try to be open to suggestions, but I do still have opinions about what this should and should not be so . . . it never hurts to ask before investing a lot of time on a patch.
## License
See [LICENSE](./LICENSE)