X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/6c33adac83ead56198010340b12e5027950601f6..89a5dde72e00feb9e86537aee5992c86ed0582d7:/doc/setup.mdwn?ds=sidebyside diff --git a/doc/setup.mdwn b/doc/setup.mdwn index 860afd6f5..11eaa6d97 100644 --- a/doc/setup.mdwn +++ b/doc/setup.mdwn @@ -1,11 +1,13 @@ This tutorial will walk you through setting up a wiki with ikiwiki. -1. [[Install]] ikiwiki. See [[download]] for where to get it. +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. + 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. @@ -32,7 +34,7 @@ This tutorial will walk you through setting up a wiki with ikiwiki. All wikis are supposed to have a [[SandBox]], so this one does too. ---- - This wiki is powered by [ikiwiki](http://ikiwiki.kitenet.net). + This wiki is powered by [ikiwiki](http://ikiwiki.info). """]] See [[HelpOnFormatting]] for details about the markup language. @@ -43,7 +45,7 @@ This tutorial will walk you through setting up a wiki with ikiwiki. 4. Build your wiki for the first time. - ikiwiki --verbose $SRCDIR $DESTDIR --url=http://host/~you/wiki/ + ikiwiki --verbose $SRCDIR $DESTDIR --url=http://example.org/~you/wiki/ Replace the url with the real url to your wiki. You should now be able to visit the url and see your wiki. @@ -64,7 +66,9 @@ This tutorial will walk you through setting up a wiki with ikiwiki. introduce setup files. A sample setup file is [[ikiwiki.setup]]. Download it (or copy it from - `doc/ikiwiki.setup` in the ikiwiki sources), and edit it. + `doc/ikiwiki.setup` in the ikiwiki sources), and edit it. Note that this + file should *not* be put in your wiki's directory with the rest of the + files. A good place to put it is in a ~/.ikiwiki/ subdirectory. Most of the options, like `wikiname` in the setup file are the same as ikiwiki's command line options (documented in [[usage]]. `srcdir` and