Manual Ikiwiki creation
- Decide on a name
reponame=hello
- Make a new git bare repo:
cd /srv/git
(or some other place for storing bare repos, just keep in mind you need to change the git wrapper in the setup file later)GIT_DIR=$reponame.git git init --shared # shared being useful if you want this to be multi-user, harmless otherwise
edit $reponame.git/description
to show an appropriate description in GitWeb/cgit
- Make a clone for yourself to work with:
cd ~/src
(or whatever)mkdir $reponame
cd $reponame
git init
- Now add some content into it.
cp /usr/share/ikiwiki/basewiki/index.mdwn .
for instance git add .
git commit
git remote add origin /srv/git/$reponame # the '.git' suffix is optional
git push origin master
git config branch.master.remote origin
git config branch.master.merge refs/heads/master
- Make a clone for Ikiwiki:
cd /srv/ikiwiki
(or some other place, just keep in mind you need to changesrcdir
in the setup file later)git clone /srv/git/$reponame
curl http://piny.be/jrayhawk/notes/examplewiki.setup | sed 's/\<examplewiki\>/$reponame/g' > $reponame.setup # feel free to put the setup file anywhere
- Tweak other settings in
$reponame.setup
(like wikiname, adminemail, urls, and add_plugins) as desired.
- Make a destination directory for rendered files:
mkdir /var/www/$reponame
(or some other place, just keep in mind you need to change destdir and cgi wrapper in the setup file now)
- Render
ikiwiki --setup $reponame.setup
--verbose
If you need to make further changes, edit /srv/ikiwiki/$reponame.setup
and run ikiwiki --setup /srv/ikiwiki/$reponame.setup --rebuild --verbose