1 This is a simple set of files for bootstrapping a git-backed instance
4 I put this together to make it easier to get started with ikiwiki than
5 following the standad instructions:
7 http://ikiwiki.info/setup/
11 Here are some of the key features of what I've got setup:
15 The ikiwiki configuration file, the templates, and source
16 files are all together in one repository.
20 The default ikiwiki setup instructions would pull in a bunch
21 of "stock" wiki pages and some underlay content. This setup
22 saves you the hassle of having to prune any of that out.
24 3. Pre-configured for git
26 Most of the git-specific settings you need are already setup
27 in ikiwiki.setup. One that is not is that the generated
28 wrapper is placed into ikiwiki-post-update rather than going
29 directly into git's post-update---so you will have to manually
30 edit post-update to call ikiwiki-post-update, (perhaps in
31 addition to anything else you want to do in post-update). See
36 To start choose where the bare git repository will exist on your web
37 server and where you'd like the HTML results to be published to. Edit
38 ikiwiki.setup and fill these in for gitrepo and destdir.
40 Next, follow these steps to setup gitrepo along with a nested checkout
41 inside of it that ikiwiki will use:
46 git clone $gitrepo ikiwiki-checkout
48 Finally, push this repository out to $gitrepo. Then edit
49 $gitrepo/hooks/post-update to call the now-generated
50 ikiwiki-post-update wrapper, (and don't forget to make chmod
51 post-update to be executable). And finally, start adding content in
52 files under src, using "git push" to publish.
54 Let me know if you have any problems or questions,
56 Carl Worth <cworth@cworth.org>