NonGNU ELPA

xkcd

Description: View xkcd from Emacs
Latest: xkcd-1.1.tar (.sig), 2024-Mar-31, 20.0 KiB
Maintainer: Vibhav Pant <vibhavp@gmail.com>
Atom feed: xkcd.xml
Website: https://github.com/vibhavp/emacs-xkcd
Browse ELPA's repository: CGit or Gitweb
Badge

To install this package from Emacs, use package-install or list-packages.

Full description

Implementation of an xkcd reader for GNU Emacs.

1. Installation

1.1. 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.

1.2. Via el-get

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

1.3. 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)

2. Screenshot:

3. 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.

4. Customization

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

Option	Use	Default value
`xkcd-cache-dir`	Directory where images and json files are cached	`~/.emacs.d/xkcd/`
`xkcd-cache-latest`	File where the latest cached xkcd's number is stored	`~/.emacs.d/xkcd/latest`

5. Keybindings:

Keybinding	Use	Function
`r`	Load a random xkcd	(xkcd-rand)
`t`	Show alt-text in the minibuffer	(xkcd-alt-text)
`<right>`	Load next xkcd	(xkcd-next)
`<left>`	Loads previous xkcd	(xkcd-prev)

NonGNU ELPA - xkcd