* Installing SuikaWiki

This document summarize how to install SuikaWiki 3. 
See also SuikaWiki:SuikaWiki//Setup 
<http://suika.fam.cx/~wakaba/-temp/wiki/wiki?SuikaWiki//Setup> for
more information.

1. Install Perl.  SuikaWiki 3 requires Perl whose version is higher than 5.8.0.
   See <http://www.perl.com/> or <http://www.cpan.org/>.

2. Install Jcode module.  This version of SuikaWiki 3 requires Jcode
   module.  It is available at <http://openlab.ring.gr.jp/Jcode/> or
   with CPAN module,

       $ perl -MCPAN -e shell
       cpan> install Jcode

3. Install BerkeleyDB and MLDBM modules.  Although SuikaWiki 3 does not
   dependes these modules, initial (default) configuration of SWHCS
   requires these modules so that you have to install them to make it
   work without modifying WikiDB configuration.

   With CPAN module,
   
        $ perl -MCPAN -e shell
        cpan> install BerkeleyDB
        cpan> install MLDBM

4. Install manakai module.  See SuikaWiki:manakai
   <http://suika.fam.cx/~wakaba/-temp/wiki/wiki?manakai>.

5. Compiling WikiPlugin modules.  There are two directories
   containing WikiPlugin modules: lib/SuikaWiki/Plugin/ and
   misc/plugins/.  The former has core modules.  All of them
   MUST be compiled.  Later is optional modules so that you
   don't have to compile all modules.

   Compiling core modules:
   
        $ cd lib/SuikaWiki/Plugin/
        $ make all

   Compiling optional modules:
   
        $ cd misc/plugins/
        $ cd subdirectory/   # if necessary
        $ make modulename.pm

     For example, to enable SuikaWiki bug tracking system, type

        $ cd misc/plugins/
        $ make bugtrack.pm

6. Copy SuikaWiki WikiEngine files to somewhere you like.
   Only directory you have to copy is lib/ (ie. SuikaWiki WikiEngine Core)
   but you might wish to copy misc/, too, to use additional WikiPlugin
   modules.  You might also wish to copy other files, for example,
   wiki.cgi, for using SuikaWiki with WWW (see "Installing SWHCS" section).

** Installing SWHCS

Install SWHCS (SuikaWiki HTTP-CGI-Script Driver) if you are interested
in accessing SuikaWiki accross WWW.

1. Install SuikaWiki WikiEngine (you should know what to do if you
   read this document from top).

2. Copy wiki.cgi in your public (world readable) directory.
   SWHCS works as a CGI-script so you need inform your web server that
   this is a CGI-script.  See documentation for your web server software.

3. Prepare WikiDatabase (and configuration) directory.  If you does not
   have it (ie. it is the first time you set up SuikaWiki),

   a. Making configuration file:

      $ cd default/
      $ make config.ph

   b. Copy default/ directory into the directory in which wiki.cgi putted
      into, with name of "wikidata".  (You can use other directory or name but
      you have to fix path in wiki.cgi and wikidata/suikawiki-config.ph.)

   c. Make directories log/ and lock/ into WikiDatabase directory:

      $ cd path/to/wikidata/
      $ mkdir log/
      $ mkdir lock/

   d. Modify path/to/wikidata/suikawiki-config.ph if necessary.
      You can skip this step unless you does not like default configuration.

4. Open wiki.cgi with your web browser (via your web server, off cource!).
   You might want to write some special-purpose WikiPages such
   as HomePage, Wiki//Admin, Wiki//Page//License, Wiki//InterWikiName,
   Wiki//Style//SuikaWiki//text/html, etc.