spacemacs/layers/+source-control/github/README.org
syl20bnr 96e7c8ee86 git and github: reorganize key bindings
gd is now "diff"
gh is now "github"
gg is not changed for "github gist" (updated the prefix name)
Inverts gc and gC since commit is more frequent than checkout
2015-11-02 00:16:13 -05:00

4.2 KiB

Github contribution layer for Spacemacs

/TakeV/spacemacs/media/commit/96e7c8ee863d39aeaf3d5dc29bcba949d01981c9/layers/+source-control/github/img/github.png

Description

This layers adds support for Github.

Features:

Install

Layer

To use this contribution add it to your ~/.spacemacs

(setq-default dotspacemacs-configuration-layers '(github))

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-c clone and optionally fork repository

Browse files

Key Binding Description
SPC g h c browse to file on github/bitbucket/etc (on current line at commit)
SPC g h C only copy the generated link on the kill ring
SPC g h l browse to file on github/bitbucket/etc (on current line position)
SPC g h L only copy the generated link on the kill ring
SPC g h o browse to file on github

Notes:

  • You can use the universal argument SPC u to select a remote repository.
  • You can use git-link on a region.
  • When the link is opened, the URL is also copied in the kill ring, you can override this behavior by setting the variable git-link-open-in-browser to nil.