WARNING: Things have changed considerably since version 0.5.1. Keep reading if you're unsure how this affects you.

Uses your local GitHub config if it can find it. See http://github.com/blog/180-local-github-config

What's new in 1.0 ?

• gist.el now maintains a local cache so as to not go to the gist server every now and then.
• multi-files gist support (indicated by a '+' in the gist list)
• improved gist-list buffer, based on tabulated-list.el (same codebase as package.el) New keybindings:
  • g : reload the gist list from server
  • e : edit current gist description
  • k : delete current gist
  • + : add a file to the current gist
  • - : remove a file from the current gist
• in-place edition. While viewing a gist file buffer, you can:
  • C-x C-s : save a new version of the gist
  • C-x C-w : rename some file
• dired integration. From a dired buffer, you can:
  • @ : make a gist out of marked files (with a prefix, make it private)

gist.el depends on a number of other modules, that you'll need to install, either manually or by way of Emacs package manager

• tabulated-list.el built-in for emacs 24. If you're using emacs 23, you can find a backport here: https://github.com/sigma/tabulated-list.el
• gh.el GitHub client library. Install from there: https://github.com/sigma/gh.el
• pcache.el Really a gh.el dependency. Install from there: https://github.com/sigma/pcache
• logito.el Really a gh.el dependency. Install from there: https://github.com/sigma/logito

In that scenario, you don't have to deal with the above dependencies yourself.

For emacs 24, first make sure http://marmalade-repo.org/ is properly configured. Then

M-x package-install RET gist RET

For emacs 23, you'll need to install a version of package.el first. Some bootstrap code is available there: https://gist.github.com/1884169 Then proceed as for emacs 24. You might get some compilation errors, but the package should be operational in the end.

After installing the required dependencies, proceed with:

$ cd ~/.emacs.d/vendor
$ git clone git://github.com/defunkt/gist.el.git

In your emacs config:

(add-to-list 'load-path "~/.emacs.d/vendor/gist.el")
(require 'gist)

When you first run a gist.el operation, you might be asked for your GitHub username and password. The username will be stored for future use, and a OAuth token will be stored in place of your password.

To make gist.el forget about those information, just remove them from your ~/.gitconfig file

gist-list - Lists your gists in a new buffer. Use arrow keys
to browse, RET to open one in the other buffer.

gist-region - Copies Gist URL into the kill ring.
With a prefix argument, makes a private gist.

gist-region-private - Explicitly create a private gist.

gist-buffer - Copies Gist URL into the kill ring.
With a prefix argument, makes a private gist.

gist-buffer-private - Explicitly create a private gist.

gist-region-or-buffer - Post either the current region, or if mark
is not set, the current buffer as a new paste at gist.github.com .
Copies the URL into the kill ring.
With a prefix argument, makes a private paste.

gist-region-or-buffer-private - Explicitly create a gist from the
region or buffer.

Set gist-view-gist to non-nil if you want to view your Gist using browse-url after it is created.

• Code: git clone git://github.com/defunkt/gist.el.git
• Home: http://github.com/defunkt/gist.el
• Bugs: http://github.com/defunkt/gist.el/issues