GHT.vim

GitHub Templates — GitHub issue and pull request template support

What + Why

GHT allows for quick editing of issue and pull request text based on the templates GitHub supports.

I like writing in Vim so much that I found myself copy/pasting the template text from the new issue and pull request pages at first, and then from the files in the repository afterwards, only to have to copy/paste it all back into GitHub before dealing with labels, milestones, and assignees. This plugin makes that process far less annoying, by only requiring the second copy/paste. ✂️📄😱

Also, one ought to know how to customize one's editor of choice, and now I know some basic vimscript. 👍

Installation

Vundle

Plugin 'nkantar/GHT.vim'

Usage

:GHTIssue
:GHTPR

Each of these commands looks for the appropriate template (/.github/ISSUE_TEMPLATE.md and /.github/PULL_REQUEST_TEMPLATE.md) in the repository's root. If no file is found, an error message is shown. If it is found, a new scratch buffer is opened with the contents of the file.

If you prefer to key mappings to commands, you probably want to add something like this to your .vimrc:

nmap <silent> ;i :call GHT('issue')<CR>
nmap <silent> ;p :call GHT('pr')<CR>

Contributing

Feel free to create and tackle issues.

You can also get in touch via email 💌 or Twitter 🐦.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.