X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/12c5786df4e74c143f24398b8d0028000b61daba..ac8e8f5ad7387a815cb0eb1b0a662694c86f2439:/doc/setup.mdwn diff --git a/doc/setup.mdwn b/doc/setup.mdwn index 2989485f9..1b8e4b12a 100644 --- a/doc/setup.mdwn +++ b/doc/setup.mdwn @@ -9,8 +9,9 @@ If you're not, see the [[download]] and [[install]] pages. ## Quick start -If you'd like to set up a wiki now, and learn more later, just run this command -and answer a couple of questions. +If you'd like to set up a wiki now, and learn more later, and you have +ikiwiki 2.60 or better installed, just run this command and answer a couple +of questions. % ikiwiki -setup /etc/ikiwiki/auto.setup What will the wiki be named? mywiki @@ -20,7 +21,7 @@ and answer a couple of questions. Wait for it to tell you an url for your new wiki.. Done! (If the CGI doesn't seem to let you edit pages, you might need to -[[configure_apache|apache_cgi]]).) +[[configure_apache|tips/apache_cgi]] or [[configure_lighttpd|tips/lighttpd_cgi]].) ## Decide where your wiki's files will go. @@ -180,39 +181,20 @@ about using the git repositories. [[!toggle id=monotone text="Monotone"]] [[!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 - BRANCH=com.company.wikiname - # remember the password you use in the next step and - # substitute it for 'wikiKeyPass' in the get_passphrase() hook below - # note the you should never generate two monotone keys with the same name - mtn genkey web@example.com - mtn db init --db=$REPOSITORY - mv $SRCDIR $SRCDIR-old - cd $SRCDIR-old - echo ".ikiwiki" > $SRCDIR-old/.mtn-ignore - mtn --db=$REPOSITORY --branch=$BRANCH import . -m "initial import" - cd .. - mtn --db=$REPOSITORY --branch=$BRANCH checkout $SRCDIR - mv $SRCDIR-old/.ikiwiki $SRCDIR - cat << EOF > $SRCDIR/_MTN/monotonerc - function get_passphrase (branchname) - return "wikiKeyPass" - end - EOF - rm -r $SRCDIR-old + # This assumes that you have already used "mtn genkey you@hostname". + REPOSITORY=~/wiki.monotone + ikiwiki-makerepo monotone $SRCDIR $REPOSITORY """]] ## Configure ikiwiki to use revision control. -Once your wiki is checked in to the revision control system, -you should configure ikiwiki to use revision control. Edit your -ikiwiki.setup, set `rcs` to the the revision control system -you chose to use. Be sure to set `svnrepo` to $REPOSITORY, if using -subversion. Uncomment the configuration for the wrapper for your revision -control system, and configure the wrapper path appropriately -(for Git, it should be `$REPOSITORY/hooks/post-update`). +Once your wiki is checked in to the revision control system, you should +configure ikiwiki to use revision control. Edit your ikiwiki.setup, set +`rcs` to the the revision control system you chose to use. Be sure to set +`svnrepo` to the directory for your repository, if using subversion. +Uncomment the configuration for the wrapper for your revision control +system, and configure the wrapper path appropriately (for Git, it should be +the path to `hooks/post-update` inside the bare git repository). 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