• Stars
    star
    111
  • Rank 314,510 (Top 7 %)
  • Language
    Emacs Lisp
  • License
    GNU General Publi...
  • Created almost 11 years ago
  • Updated over 2 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Read xkcd from Emacs

emacs-xkcd

https://travis-ci.org/vibhavp/emacs-xkcd.png

http://melpa.org/packages/xkcd-badge.svg

Implementation of an xkcd reader for GNU Emacs.

Installation

Via package.el

emacs-xkcd is available on MELPA and Marmalade. Just add any of these to your package archives, and install the package with M-x package-install xkcd.

Via el-get

Emacs xkcd can also be installed using el-get. To do so, run M-x el-get-install xkcd

Via Git

Clone this repo to a desired location, add the directory to your load path:

(add-to-list 'load-path (expand-file-name "/path/to/emacs-xkcd"))
(require 'xkcd)

Screenshot:

./images/screenshot.png

Viewing comics:

  • xkcd-get loads a user-specific xkcd.

Files are cached (for later offline viewing) by default to ~/.emacs.d/xkcd/. This can be changed by changing xkcd-cache-dir in emacs-xkcd’s customize menu. (customize-group xkcd)

  • xkcd loads the latest xkcd.

Customization

emacs-xkcd can be customized with M-x customize-group xkcd.

OptionUseDefault value
xkcd-cache-dirDirectory where images and json files are cached~/.emacs.d/xkcd/
xkcd-cache-latestFile where the latest cached xkcd’s number is stored~/.emacs.d/xkcd/latest

Keybindings:

KeybindingUseFunction
rLoad a random xkcd(xkcd-rand)
tShow alt-text in the minibuffer(xkcd-alt-text)
<right>Load next xkcd(xkcd-next)
<left>Loads previous xkcd(xkcd-prev)

Stuff yet to be added:

View title in user-defined faces.

Handle links to xkcd in Emacs with xkcd-get.