summaryrefslogtreecommitdiff
path: root/notes/ikiwiki_creation.mdwn
blob: b84c17adcefaf125910d6cfdc61b286b2fb238a3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# Manual Ikiwiki creation

0. Decide on a name
   - `reponame=hello`
1. 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 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
2. 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`
3. Make a clone for Ikiwiki:
   - `cd /srv/ikiwiki` (or some other place, just keep in mind you need to change `srcdir` later)
   - `git clone --shared /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.
4. Make a destination directory for rendered files:
   - `sudo mkdir /var/www/$reponame` (or some other place, just keep in mind you need to change destdir now)
5. Render
   - `sudo -u ikiwiki ikiwiki --setup $reponame.setup`