/browse-at-remote

Browse target page on github/bitbucket from emacs buffers

Primary LanguageEmacs Lisp

browse-at-remote.el

This package is easiest way to open particular link on github/gitlab/bitbucket/stash from Emacs. It supports various kind of emacs buffer, like:

  • file buffer
  • dired buffer
  • magit-mode buffers represinting code
  • vc-annotate mode (use get there by pressing C-x v g by default)

Installation:

Add browse-at-remote to your Cask file::

(depends-on "browse-at-remote")

Manual

Simply add this package to your emacs path, and add to .emacs,:

(require 'browse-at-remote)

Active keybindings for browse-at-remote function::

(global-set-key (kbd "C-c g g") 'browse-at-remote)

If your repository is hosted on GitHub enterprise, you should add following setting to its config::

git config --add browseAtRemote.type "github"

For private Stash repitory use command::

git config --add browseAtRemote.type "stash"

Usage:

  1. Call function from emacs buffer:

    M-x browse-at-remote

    or:

    M-x bar-browse
    http://i.imgur.com/rmAky8e.png

    or just call C-c g g if you've already added binding before. You can use this command in dired buffers too.

  2. Target page at github/bitbucket will be opened using your default browser:

    http://i.imgur.com/wBW9Gov.pngalt:screenshotofpageatgithub

    or same here is folder view at bitbucket:

    http://i.imgur.com/XuzLhcR.pngalt:screenshotpagetreeatbibucket

  3. Opening github commit's page at magit-commit-mode, magit-log-mode:

    http://i.imgur.com/NzlIHYr.pngalt:screenshotof*magit-log-mode*

  4. Open last commit which added target line:

    http://i.imgur.com/lpmOAz2.pngalt:screenof*vc-annotate-mode*
    • Press C-x v g to call standard vc-annotate
    • Call browse-at-remote on target line

Contributors:

Changelog:

0.9.0

Minor fixes, added Stash (bitbucket support) by @yauhen-l.

0.8.0

Drop clojure-style function namings. Add abbrev methods like bar-browse and bar-to-clipoboard (where bar is browse-at-remote abbrev.)

0.7.0

Major refactorings by @ieure. Main function renamed to browse-at-remote/browse. (renamed in 0.8.0 to bar-browse)

0.6.0

  • Added support of Gitlab by @env0der. Thanks!

0.5.0

  • Added support of Github Enterprice. Special thanks for @env0der for this feature.

0.4.0

  • Function browse-at-remote/to-clipboard were added (renamed in 0.8.0 to bar-to-clibpoard)

TODO:

  • Add mercurial support