X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/5fca625a13d2ca0267dbd80c29253554dc8ad20a..930584cff747d87635da192585030d4fb30a2893:/doc/setup.mdwn diff --git a/doc/setup.mdwn b/doc/setup.mdwn index 98ac90460..f5dd8832e 100644 --- a/doc/setup.mdwn +++ b/doc/setup.mdwn @@ -119,33 +119,24 @@ This tutorial will walk you through setting up a wiki with ikiwiki. [[toggle id=git text="Git"]] [[toggleable id=git text=""" - For Git, you need two repositories, of which one should be bare - (meaning that it does not have a working tree checked out). We call - the bare repository the "repo" and the other the "srcdir" ($srcdir). + When using Git, you probably want to set up two repositories, of which + one should be bare (meaning that it does not have a working tree + checked out). We call the bare repository the "repository" and the + other will be the "srcdir" (which `ikiwiki` uses to compile the wiki). There are [other ways](http://blog.madduck.net/vcs/2007.07.11_publishing-git-repositories) to do the following, but this might be easiest: - REPOSITORY=./wiki.git - # SRCDIR is where ikiwiki compiles from. You thus need - # to set $srcdir in ikiwiki.setup appropriately. The - # -wc in the name suggests "working clone" because - # $SRCDIR holds a Git repository with a working tree. - SRCDIR=./wiki-wc + REPOSITORY=~/wiki.git + GIT_DIR=$REPOSITORY git --bare init --shared cd $SRCDIR git init - echo "Initial index page" > index.mdwn - echo .ikiwiki > .gitignore - git add index.mdwn .gitignore - git commit -m'Initial commit' - git config receive.denyNonFastForwards true - git config core.bare true - mv .git $REPOSITORY - test -d .ikiwiki && mv .ikiwiki .. - cd .. - rm -r $SRCDIR - git clone -l -s $REPOSITORY $SRCDIR - test -d .ikiwiki && mv .ikiwiki $SRCDIR + echo /.ikiwiki > .gitignore + git add . + git commit -m "initial commit" + git remote add origin $REPOSITORY + git config branch.master.merge refs/heads/master + git push --all It is **paramount** that you **never** push to the Git repository in `$SRCDIR` ([this FAQ entry explains @@ -154,17 +145,11 @@ This tutorial will walk you through setting up a wiki with ikiwiki. `$REPOSITORY`, using either the `git` transport (if available), or `ssh`. - To automatically update the wiki when you push changes to - `$REPOSITORY`, `ikiwiki` can install a `post-update` hook. You need to - enable this hook in `ikiwiki.setup` and the path to use should be - `$REPOSITORY/hooks/post-update`. - - Finally, then, setup `ikiwiki`: - - ikiwiki --setup ikiwiki.setup + If at any point you commit changes in `$SRCDIR`, make sure to `git + push` them to the `$REPOSITORY`. ikiwiki will do this automatically + for any changes made via the web. - If you commit changes in `$SRCDIR`, make sure to `git push` them to - the `$REPOSITORY`. + Finally, see [[Git_pitfalls]] if you experience problems. """]] [[toggle id=tla text="TLA"]] @@ -191,7 +176,7 @@ This tutorial will walk you through setting up a wiki with ikiwiki. """]] [[toggle id=monotone text="Monotone"]] - [[toggleable id=montone text=""" + [[toggleable id=monotone text=""" # These instructions are standard instructions to import a directory into monotone # and set it up so that you don't need any passwords to use it REPOSITORY=~/.ikiwiki/mtn.db @@ -224,8 +209,8 @@ This tutorial will walk you through setting up a wiki with ikiwiki. you chose to use. Be sure to set `svnrepo` to $REPOSITORY, if using subversion. Uncomment the block for the wrapper for your revision control system, and configure the wrapper path in that block - appropriately. - + appropriately (for Git, it should be `$REPOSITORY/hooks/post-update`). + Once it's all set up, run `ikiwiki --setup ikiwiki.setup` once more. Now you should be able to edit files in $SRCDIR, and use your revision control system to commit them, and the wiki will automatically update.