OddmuseCurl

Oddmuse Curl Mode is a fork of a very old revision of OddmuseMode maintained by AlexSchroeder. Use it to edit Oddmuse wikis such as Emacs Wiki.

Cool features:

Download

The code is maintained on GitHub using Git:

Setup

A typical setup:

;;; Oddmuse

(setq oddmuse-username "AlexSchroeder")
(add-to-list 'auto-mode-alist '("/Users/alex/.emacs.d/oddmuse" . oddmuse-mode))
(autoload 'oddmuse-edit "oddmuse-curl"
  "Edit a page on an Oddmuse wiki." t)
(add-to-list 'vc-handled-backends 'oddmuse)
(defun vc-oddmuse-registered (file)
  "Handle files in `oddmuse-directory'."
  (string-match (concat "^" (expand-file-name oddmuse-directory))
		(file-name-directory file)))

Adding to ‘vc-handled-backends’ and the definition of ‘vc-oddmuse-registered’ would be part of autoloads, if this file was distributed with Emacs. As it stands, you could instead (require 'vc-oddmuse). It’s just that I want to keep my Emacs startup speed down and that’s why I don’t.

Key Map

‘oddmuse-edit’ asks you for a wiki and a page name and allows you to edit it.

Once you’re editing a wiki page, here are some useful keybindings:

‘C-c C-b’
browse this page in a web browser
‘C-c C-c’
post the changes you made
‘C-c C-e’
edit a page
‘C-c C-f’
follow a link
‘C-c C-h’
look at the history of the page you are editing
‘C-c C-i’
insert an existing page name (avoiding typos)
‘C-c C-m’
toggle posting minor changes – often people will make a big change and continue fixing later typos using minor changes
‘C-c C-n’
create a new page with the current date as the default page name (useful for blogging)
‘C-c C-p’
preview the current page
‘C-c C-r’
list recent changes to the wiki
‘C-c C-s’
search the wiki
‘C-c C-t’
insert HTML tag
‘C-x C-v’
revert your changes
‘C-x v l’
look at all past changes of the page you are editing
‘C-x v =’
look at the diff of what you will be posting
‘C-x v u’
revert you changes

Why curl?

This mode is in part an illustration of how to use a generic command line tool like ‘curl’ to edit Oddmuse wikis.

Get Curl

OSX already comes with curl.

On Windows, I use curl installed via CygWin, as you can see from my eshell buffer:

~ $ which curl
c:/cygwin64/bin/curl.exe

More information on the curl homepage.


CategoryHypermedia