- Ikiwiki requires [[MarkDown]] be installed, and also uses the following
- perl modules: `CGI::Session` `CGI::FormBuilder` (version 3.02.02 or
- newer) `HTML::Template` `Mail::SendMail` `Time::Duration` `Date::Parse`
- (libtimedate-perl), `HTML::Scrubber`
-
-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. Build your wiki for the first time.
-
- ikiwiki --verbose ~/wikiwc/ ~/public_html/wiki/ \
- --url=http://host/~you/wiki/
+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
+
+5. Build your wiki for the first time.
+
+ ikiwiki --verbose $SRCDIR $DESTDIR --url=http://host/~you/wiki/