X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/f0d7a5ee1a9fe6ea28b63544904e5126faad12ec..ce942821d30ed84f320f17c8cb4f990186dd2f4f:/doc/setup.mdwn diff --git a/doc/setup.mdwn b/doc/setup.mdwn index df553cfb3..e9c690f45 100644 --- a/doc/setup.mdwn +++ b/doc/setup.mdwn @@ -8,6 +8,7 @@ optional support for commits from the web. 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. @@ -29,16 +30,16 @@ optional support for commits from the web. 5. Build your wiki for the first time. - ikiwiki --verbose ~/wikiwc/ \ - /usr/share/ikiwiki/templates ~/public_html/wiki/ \ - --url=http://host/~you/wiki/ + ikiwiki --verbose ~/wikiwc/ ~/public_html/wiki/ \ + --url=http://host/~you/wiki/ - Replace the url with the right url to your wiki. You should now + Replace the url with the real url to your wiki. You should now be able to visit the url and see your page that you created earlier. 6. Repeat steps 4 and 5 as desired, editing or adding pages and rebuilding the wiki. You can play around with other ikiwiki parameters such as - --wikiname too. Get confortable with its command line. + `--wikiname` and `--rebuild` too. Get comfortable with its command line + (see [[usage]]). 7. By now you should be getting tired of typing in all the command line options each time you change something in your wiki's setup. And it's @@ -49,8 +50,8 @@ optional support for commits from the web. `doc/ikiwiki.setup` in the ikiwiki sources), and edit it. Most of the options, like `wikiname` in the setup file are the same as - ikiwiki's command line options (documented in [[usage]]. `srcdir`, - `templatedir` and `destdir` are the three directories you specify when + ikiwiki's command line options (documented in [[usage]]. `srcdir` + and `destdir` are the two directories you specify when running ikiwiki by hand. `svnrepo` is the path to your subversion repository. Make sure that all of these are pointing to the right directories, and read through and configure the rest of the file to your @@ -71,10 +72,10 @@ optional support for commits from the web. 9. Add [[PageHistory]] links to the top of pages. This requires you to have setup [[ViewCVS]] or something similar to access your [[Subversion]] repository. The `historyurl` setting makes ikiwiki add the links, and - in that url, "[[]]" is replaced with the name of the file to view. So + in that url, "\[[file]]" is replaced with the name of the file to view. So edit ikiwiki.setup and set `historyurl` to something like this: - `http://svn.host/trunk/[[]]?root=wiki` + `http://svn.host/trunk/\[[file]]?root=wiki` Then run `ikiwiki --setup ikiwiki.setup` again.