-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. Create the master rcs repository for your wiki.
-
- # Subversion
- svnadmin create /svn/wikirepo
- svn mkdir file:///svn/wikirepo/trunk -m create
-
- # Git
- mkdir /git/wikirepo
- cd /git/wikirepo
- 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 /tla
- tla make-archive me@localhost--wiki /tla/wikirepo
- tla my-id "<me@localhost>"
-
- # Mercurial
- hg init /hg/wikirepo
-
-3. Check out the repository to make the working copy that ikiwiki will use.
-
- # Subversion
- svn co file:///svn/wikirepo/trunk ~/wikiwc
-
- # Git
- # Create a local clone to save disk space and also to
- # optimize performance. See git-clone(1).
- git clone -l -s /git/wikirepo ~/wikiwc
-
- # TLA
- mkdir ~/wikiwc
- cd ~/wikiwc
- 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 the ~/wikiwc working copy we symlink it:
- ln -s /hg/wikirepo ~/wikiwc
+This tutorial will walk you through setting up a wiki with ikiwiki.
+
+1. [[Download]] and [[install]] ikiwiki.
+
+2. Decide where your wiki's files will go.
+
+ As a wiki compiler, ikiwiki builds a wiki from files in a source directory,
+ and outputs the files to a destination directory. If you keep your wiki in
+ a version control system, the source directory will contain a working copy
+ checked out from the version control system.
+
+ For the purposes of this tutorial, we'll set shell variables
+ for these locations, and use those variables in the commands that follow.
+
+ SRCDIR=~/wikiwc
+ DESTDIR=~/public_html/wiki/
+
+ Note that ikiwiki owns the working copy directory; do not perform your own
+ edits in ikiwiki's working copy.
+
+3. Create the beginnings of your wiki.
+
+ This will create a simple main page for the wiki.
+
+ mkdir $SRCDIR
+ cd $SRCDIR
+ $EDITOR index.mdwn
+
+ In the editor, you could start by entering a simple page like
+ [[toggle id=page text="this one"]].
+
+ [[toggleable id=page text="""
+ Welcome to your new wiki.
+ All wikis are supposed to have a [[SandBox]],
+ so this one does too.
+ ----
+ This wiki is powered by [ikiwiki](http://ikiwiki.info).
+ """]]
+
+ See [[HelpOnFormatting]] for details about the markup language.
+
+ Note that several [[standard_wiki_pages|basewiki]] will be added to your
+ wiki, from files in `/usr/share/ikiwiki/basewiki/`, so your wiki will
+ automatically get a [[SandBox]], and some other useful pages.