web commit by UlrikSverdrup: minor: markup
[ikiwiki.git] / doc / rcs / git / discussion.mdwn
1 ## Migrating from svn to git ##
2
3 I'd like to migrate from svn to git, because git is better in general but also has some nice properties that go well together with my use of ikiwiki.. I only change it myself. I want a single git repo so that my website directory is self-contained so that I don't need to drag around a separate svn repository on my computer. Is it possible to use ikiwiki so that it only uses a git repository in the same dir as all files are stored and edited?
4
5 Otherwise, I hope migrating is just importing the svn repo to git and then setting up ikiwiki to use git. I don't plan to go back to svn after that so git-svn should only do the import.
6
7 ### Solution ###
8 **Basis:** I only use ikiwiki as a wiki compiler. No cgi or anything.
9
10 I imported my svn repo into git with `git-svnimport`. I reconfigured ikiwiki to _not use any rcs_. In `ikiwiki.setup`, I have the git repository as srcdir, and a suitable dstdir. 
11
12 Then, in my git repository, I added this `post-commit` hook to refresh the wiki:
13
14         #!/bin/sh
15
16         # to refresh when changes happen
17
18         #!/bin/sh
19
20         # to refresh when changes happen
21
22         BASE="/path/to/base/dir"
23         SETUPFILE="$BASE/ikiwiki.setup"
24         UNDERLAYDIR="$BASE/underlay"
25
26         ikiwiki --refresh --setup "$SETUPFILE" --underlaydir="$UNDERLAYDIR" --verbose   
27
28 UlrikSverdrup