-So you want to set up your own wiki using ikiwiki? This turorial will walk
-you through setting up a wiki that is stored in [[Subversion]] and that has
-optional support for commits from the web.
-
-1. [[Install]] ikiwiki.
-
- apt-get install ikiwiki # soon
-
- Ikiwiki requires [[MarkDown]] be installed, and also uses the following
- perl modules: `CGI::Session` `CGI::FormBuilder` `HTML::Template`
- `Mail::SendMail` `Time::Duration`
-
-2. Create the subversion repository for your wiki.
-
- svnadmin create /svn/wikirepo
- svn mkdir file:///svn/wikirepo/trunk -m create
-
-3. Check out the repository to make the working copy that ikiwiki will use.
-
- svn co file:///svn/wikirepo/trunk ~/wikiwc
-
-4. Create some files and add them into subversion. Or you might copy the
- files from /usr/share/ikiwiki/basewiki and check those in to get a
- head start on creating your wiki.
-
- echo "Welcome to my empty wiki." > ~/wikiwc/index.mdwn
- echo "Feel free to edit this page" > ~/wikiwc/sandbox.mdwn
- svn add ~/wikiwc/*.mdwn
- svn commit ~/wikiwc -m add
+So you want to set up your own wiki using ikiwiki? This tutorial will walk
+you through setting up a wiki that is stored in [[Subversion]], [[Git]],
+[[TLA]] or [[Mercurial]], and that has optional support for commits from the web.
+
+1. [[Install]] ikiwiki. See [[download]] for where to get it.
+
+2. Decide where your wiki's files will go.
+
+ Pick three directories for respectively the repository (contains
+ the "master copy" and history); working copy (checked-out
+ files from the repository); and web pages (served by the web server).
+
+ For the purposes of this tutorial, we'll set shell variables
+ for these locations, and use those variables in the commands that follow.
+
+ REPOSITORY=~/wikirepo
+ SRCDIR=~/wikiwc
+ DESTDIR=~/public_html/wiki/
+
+3. Create the master rcs repository for your wiki.
+
+ # Subversion
+ svnadmin create $REPOSITORY
+ svn mkdir file://$REPOSITORY/trunk -m create
+
+ # Git
+ mkdir $REPOSITORY
+ cd $REPOSITORY
+ git init-db
+ # Git requires something be in the repo to start with.
+ cp /usr/share/ikiwiki/basewiki/index.mdwn .
+ git add .
+ git commit -m create -a
+ # No need to keep files in the master repository; so at this
+ # stage, you may want to remove all files (except .git) to
+ # save disk space.
+
+ # TLA
+ mkdir $REPOSITORY
+ tla make-archive me@localhost--wiki $REPOSITORY
+ tla my-id "<me@localhost>"
+
+ # Mercurial
+ hg init $REPOSITORY
+
+4. Check out the repository to make the working copy that ikiwiki will use
+ as its source directory.
+
+ # Subversion
+ svn co file://$REPOSITORY/trunk ~/wikiwc
+
+ # Git
+ # Create a local clone to save disk space and also to
+ # optimize performance. See git-clone(1).
+ git clone -l -s $REPOSITORY $SRCDIR
+
+ # TLA
+ mkdir $SRCDIR
+ cd $SRCDIR
+ tla archive-setup me@localhost--wiki/wiki--0
+ tla init-tree me@localhost--wiki/wiki--0
+ # Edit {arch}/=tagging-method and change the precious
+ # line to add the .ikiwiki directory to the regexp.
+ tla import
+
+ # Mercurial
+ # Mercurial uses a single repo approach, so no need to
+ # clone anything. Because the following examples
+ # refer to $SRCDIR, we symlink it:
+ ln -s $REPOSITORY $SRCDIR