Skip to content

vibhavp/emacs-xkcd

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 

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.

About

Read xkcd from Emacs

Resources

License

Stars

Watchers

Forks

Packages

No packages published