**Summary**

*HeyHeyWickie* is an experimental implementation of a WikiWiki sytem.
It is at the same time both minimal and highly flexible because it allows 
you to include arbitrary source code in any page.

**License**

This software is released under the `GPL <http://www.gnu.org/copyleft/gpl.html>`__.

**Download**

*HeyHeyWickie* is distributed as an archive named ``heyheywickie.tar.gz``. 
This tar-ball consists of a single Python module named ``wickie4K.py`` 
(which is an initial version of less than four KB of code) plus a directory 
named ``wickiedata`` containing an initial set of Wiki pages.
The archive is available here: 
http://python.net/~gherman/tmp/heyheywickie.tar.gz.


**Preconditions**

*HeyHeyWickie* needs four things to be installed on your local machine 
before you can run it (the first two are most often preinstalled on any 
decent Unix-like OS):

1. The `Python <http://www.python.org>`__ interpreter  

2. The `Apache <http://httpd.apache.org>`__ webserver

3. The `Docutils <http://docutils.sf.net>`__ package 
   (`download Docutils... <http://sourceforge.net/project/showfiles.php?group_id=38414>`__)

4. The `EmPy <http://www.alcyone.com/pyos/empy/>`__ module
   (`download empy-latest.tar.gz <http://www.alcyone.com/pyos/empy/empy-latest.tar.gz>`__)

(The @SlashdotNews page makes use of a module named *xml2obj* by 
John Bair, available here: 
http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/149368
which is included in this distribution in a slightly extended version.)

**Installation**

The current installation procedure isn't yet automated, but don't panic, 
you only need to copy some files at the right places and verify they have
the correct permissions.

- Copy the file ``wickie4K.py`` to a CGI directory, which can be accessed 
  by Apache.
  (Depending on your local Apache configuration, you might need to rename 
  it to ``wickie4K.cgi``.)

- Edit ``wickie4K.py`` and set the global variable ``WIKI_DIR`` to the 
  directory serving as the repository for all Wiki pages (e.g. 
  ``"/Library/WebServer/Documents/wickiedata/"`` 
  if you happen to be on a Mac OS X system).

- Make sure the file ``wickie4K.py`` (or ``.cgi``) is executable by the user 
  normally running Apache, most often ``nobody`` or ``www``.

- Copy the directory ``wickiedata`` from the distribution archive to the 
  location specified by ``WIKI_DIR``.

- Make sure this directory is writable for the normal Apache user and the 
  files inside it are also writable for the very same user.

**Launching**

You now launch *HeyHeyWickie* simply by pointing your local web browser 
to a URL like http://localhost/cgi-bin/wickie4K.py (or maybe ``.cgi``). 
Note that depending on your 
local Apache configuration the URL needs to contain a path like ``cgi-bin``. 
Now you should see *HeyHeyWickie* displaying its front page!

**Author**

This module was written by `Dinu Gherman <http://python.net/~gherman>`__. 
If you use this software, have suggestions for future releases, or bug reports, 
`I'm glad to hear about <mailto:gherman@@darwin.nospam.in-berlin.de>`__ it.