summaryrefslogtreecommitdiff
path: root/notes/ikiwiki_creation.mdwn
diff options
context:
space:
mode:
authorJoe Rayhawk <jrayhawk@richardiv.omgwallhack.org>2010-12-12 18:37:40 -0800
committerJoe Rayhawk <jrayhawk@richardiv.omgwallhack.org>2010-12-12 18:37:40 -0800
commitfb11132d06ede2223990a48e92e0a396a134c63b (patch)
tree1211fceb3796b4971844e1014207dee63dae81f5 /notes/ikiwiki_creation.mdwn
parentffa3d7b465b73efc7f4782946012582a4e913eaf (diff)
downloadjrayhawk-fb11132d06ede2223990a48e92e0a396a134c63b.tar.gz
jrayhawk-fb11132d06ede2223990a48e92e0a396a134c63b.zip
Notes: add Ikiwiki manual creation
Diffstat (limited to 'notes/ikiwiki_creation.mdwn')
-rw-r--r--notes/ikiwiki_creation.mdwn29
1 files changed, 29 insertions, 0 deletions
diff --git a/notes/ikiwiki_creation.mdwn b/notes/ikiwiki_creation.mdwn
new file mode 100644
index 0000000..4c03752
--- /dev/null
+++ b/notes/ikiwiki_creation.mdwn
@@ -0,0 +1,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, 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`