KristianLyng/wikish

=======================================================
Wikish is a basic shell script to edit a mediawiki wiki
=======================================================

.. sectnum::

.. contents::


Dependencies
============

Dependencies in order of what you're least likely to already have:

- lwp-request (with ssl-support if you use https. SSLeay )
- curl
- gawk (I think. Might work with mawk too)
- diff (For EDIT-mode)
- date
- sh (meh....)
- mv
- cp

Installation
============

Move wikish.config to ~/.config/, edit it and then set up wiki.sh
somewhere. It creates a few trash-files so you may want to keep it in a
directory.

Symlinks understood: wikiedit, wikiget, wikipost:

./wiki.sh GET Foo == ./wikiget Foo
./wiki.sh EDIT Foo == ./wikiedit Foo
./wiki.sh POST Foo == ./wikipost Foo

If you work with multiple wikis, you can override settings on a
directory-basis, copying the wikish.config to .wikish.config in the
respective directory. So to work with wiki.varnish-software.com and
wiki.redpill-linpro.com, you can have:

~/.config/wikish.config ("global" stuff?)
~/Wiki/rpl/.wikish.config
~/Wiki/vs/.wikish.config

Now working in ~/Wiki/rpl/ and ~/Wiki/vs/ is two different wikis.

Usage
=====

Editing::

	wiki.sh GET Some_Page
	vim Some_Page
	wiki.sh POST Some_Page

OR: ``wiki.sh EDIT Some_Page``
OR, if you symlinked: ``wikiedit Some_Page``

To create a new page, just edit Some_New_Page.wiki (from a blank file),
then post it.

Feedback
========

Comments/suggestions go to: Kristian Lyngstol kristian@bohemians.org

Code at: http://github.com/KristianLyng/wikish , including simple issues if
you prefer that over mail.