spacemacs/layers/+source-control/github/README.org

Github layer

• Description
  • Features:
• Install
  • Layer
  • Git configuration
• Key Bindings
  • magit-gh-pulls
  • gist.el
  • Clone repositories
  • Browse files

Description

This layers adds support for Github.

Features:

• magit-gh-pulls: handy magit add-on to manage Github pull requests.
• gist.el: full-featured mode to browse and post Github gists.
• github-browse-file and git-link: quickly browse github URL in your browser.
• Github clone allows for easy cloning and forking of repositories.

Install

Layer

To use this configuration layer, add it to your ~/.spacemacs. You will need to add github to the existing dotspacemacs-configuration-layers list in this file.

Git configuration

You will need to generate a personal access token on GitHub. This token should have the gist and repo permissions. Once this token is created, it needs to be added to your ~/.gitconfig

  git config --global github.oauth-token <token>

Key Bindings

magit-gh-pulls

In a magit status buffer (SPC g s):

Key Binding	Description
# c	create a pull request
# g	get a list of all PRs in the current repository
# f	fetch the commits associated to the current PR
# b	create a branch for the current PR
# m	merge the PR with current branch

Note that magit-gh-pulls will try to fast-forward the PRs whenever it is possible.

gist.el

Key Binding	Description
SPC g g b	create a public gist with the buffer content
SPC g g B	create a private gist with the buffer content
SPC g g l	open the gist list buffer
SPC g g r	create a public gist with the region content
SPC g g R	create a private gist with the region content

In the gist list buffer:

Key Binding	Description
/	evil search
+	add buffer to gist
-	remove file for gist
b or o	open current gist in browser
f	fetch current gist
g	refresh the list
h	go left
j	go down
k	go up
K	kill current gist
l	go right
n	next search occurrence
N	next previous occurrence
v	visual state
V	visual-line state
y	print URL and copy it

Clone repositories

Key Binding	Description
SPC g h c /	search for a repository to clone it
SPC g h c c	clone and optionally fork repository
SPC g h c r	add a remote that is an existing fork of selected remote
SPC g h c f	fork remote in current user namespace
SPC g h c u	add upstream as remote

Browse files

Key Binding	Description
SPC g h o	browse to file on github