This is a simple set of files for bootstrapping a git-backed instance
of ikiwiki.

I put this together to make it easier to get started with ikiwiki than
following the standad instructions:

	http://ikiwiki.info/setup/

Features
========
Here are some of the key features of what I've got setup:

1. Self-contained.

	The ikiwiki configuration file, the templates, and source
	files are all together in one repository.

2. Minimal

	The default ikiwiki setup instructions would pull in a bunch
	of "stock" wiki pages and some underlay content. This setup
	saves you the hassle of having to prune any of that out.

3. Pre-configured for git

	Most of the git-specific settings you need are already setup
	in ikiwiki.setup. One that is not is that the generated
	wrapper is placed into ikiwiki-post-update rather than going
	directly into git's post-update---so you will have to manually
	edit post-update to call ikiwiki-post-update, (perhaps in
	addition to anything else you want to do in post-update). See
	below.

Usage
=====
To start choose where the bare git repository will exist on your web
server and where you'd like the HTML results to be published to. Edit
ikiwiki.setup and fill these in for gitrepo and destdir.

Next, follow these steps to setup gitrepo along with a nested checkout
inside of it that ikiwiki will use:

	mkdir -p $gitrepo
	cd $gitrepo
	GIT_DIR=. git init-db

Then, push the contents of this repository out to $gitrepo and
continue with the following commands (still with $gitrepo as the
current working directory):

	git clone $gitrepo ikiwiki-checkout
	cd ikiwiki-checkout
	ikiwiki --setup ikiwiki.setup

And finally, edit $gitrepo/hooks/post-update to call the new
$gitrepo/hooks/ikiwiki-post-update program and also don't forget to
actually enable the hook with:

	chmod a+x $gitrepo/hooks/post-update .

Now, you're finally ready to go, and you should be able to just start
adding content under the src directory and use "git push" to publish
them. To preview things locally, just run "ikiwiki --setup
ikiwiki.setup", (and ensure the destination paths exist on the local
machine as well).

Let me know if you have any problems or questions,

Carl Worth <cworth@cworth.org>