64 lines
2.2 KiB
Markdown
64 lines
2.2 KiB
Markdown
# rhubarb.vim
|
|
|
|
If [fugitive.vim][] is the Git, rhubarb.vim is the Hub. Here's the full list
|
|
of features:
|
|
|
|
* Enables `:GBrowse` from fugitive.vim to open GitHub URLs.
|
|
|
|
* In commit messages, GitHub issues, issue URLs, and collaborators can be
|
|
omni-completed (`<C-X><C-O>`, see `:help compl-omni`). This makes inserting
|
|
those `Closes #123` remarks slightly easier than copying and pasting from
|
|
the browser.
|
|
|
|
[fugitive.vim]: https://github.com/tpope/vim-fugitive
|
|
|
|
## Installation
|
|
|
|
If you don't have a preferred installation method, I recommend
|
|
installing [pathogen.vim](https://github.com/tpope/vim-pathogen), and
|
|
then simply copy and paste:
|
|
|
|
cd ~/.vim/bundle
|
|
git clone https://github.com/tpope/vim-rhubarb.git
|
|
vim -u NONE -c "helptags vim-rhubarb/doc" -c q
|
|
|
|
You'll also need [fugitive.vim][].
|
|
|
|
[Curl](http://curl.haxx.se/) (included with macOS) is required for features
|
|
that use the GitHub API (i.e., `:GBrowse` doesn't need it).
|
|
[Generate a personal access token](https://github.com/settings/tokens/new)
|
|
with repo permissions and add it to your `.netrc`:
|
|
|
|
echo 'machine api.github.com login <user> password <token>' >> ~/.netrc
|
|
|
|
If you are using GitHub Enterprise, repeat this step for each domain (omit the
|
|
`api.` portion). You'll also need to tell Rhubarb the root URLs:
|
|
|
|
let g:github_enterprise_urls = ['https://example.com']
|
|
|
|
## FAQ
|
|
|
|
> How do I turn off that preview window that shows the issue body?
|
|
|
|
set completeopt-=preview
|
|
|
|
> What happened to the support for [`hub`](https://github.com/github/hub)?
|
|
|
|
Support was dropped partially because [GitHub CLI](https://github.com/cli/cli)
|
|
appears to be unseating it as the preferred GitHub command line solution, and
|
|
partially because `hub` isn't quite a perfect drop-in replacement for `git`,
|
|
making life more difficult for Fugitive. My recommended solution is to call
|
|
it via a Git alias:
|
|
|
|
git config --global alias.hub '!hub'
|
|
|
|
This will let you call `hub pull-request` via `:Git hub pull-request`, for
|
|
example.
|
|
|
|
## Self-Promotion
|
|
|
|
Like rhubarb.vim? Follow the repository on
|
|
[GitHub](https://github.com/tpope/vim-rhubarb). And if
|
|
you're feeling especially charitable, follow [tpope](http://tpo.pe/) on
|
|
[Twitter](http://twitter.com/tpope) and
|
|
[GitHub](https://github.com/tpope).
|