[15] 重要: SuikaWiki2 は既に維持管理されていません。 SuikaWiki3 を御利用下さい。

事情があって SuikaWiki 2 を使用されたい方は、 CVS から取り出す際に、 branch-suikawiki-1 枝を指定してください。 (枝名は branch-suikawiki-1 ですが、実際には SuikaWiki 2 です。)

SuikaWiki を動かすためのメモ

[13] 以下に書いてある通りに操作すると、 SuikaWiki が動くようになる可能性があります。

SuikaWiki 及び必要モジュールの入手と導入

[14] 必要なものと入手先一覧:

[3] manakai と Char::Class の install は、 それぞれの WikiPage を見て下さい。どちらも pure perl ですが、 Char::Class は直接使用可能な形式で配布されていないので、 perl module を生成する必要があります。 (一度生成すれば architecture に依存しないので他のサーバーに持っていっても OK。なお、現時点で必要なのは Char::Class::XML だけなのでこれ1個作れば十分。) manakai も Char::Class も、他の script で使用しないのなら、 SuikaWiki の lib directory に突っ込めば OK です。

[4] SuikaWiki 本体は、もちろん httpd から見える適当な directory に配置します。 といっても、見える必要があるのは wiki.cgi だけで、後のファイルは、 wiki.cgi と wikidata/suikawiki-config.ph の最初の方にある path を適当に指定すれば、どこにあっても問題ないです。

WikiDatabase のための場所の確保

[5] WikiPage database のための場所を用意します。既定値では CGI script の directory 内の wikidata という subdirectory です。新しく作る時は CVS の同じ場所にある default という directory の名前を変更します (この中には最低限必要であろう WikiPage が含まれています)。

[7] wikidata directory 内に、 page, lock, log という3つの directory を作っておきます。これらはそれぞれ、 WikiPage, lock file, 記録を入れるのに使われます。 (これらを他の場所とか他の名前にしたいときは、 suikawiki-config.ph で書き換えてください。 suikawiki-config.ph 以外の書き換えが必要だとしたらそれは不具合なので、報告してください。)

設定ファイル

[6] wikidata/suikawiki-config.ph は当該 wiki の設定ファイルです。 >>4 で配置を変更した場合はこのファイル内の経路も正しく設定しないといけません。

重要: CVS の default/suikawiki-config.ph は古くて使い物にならないかもしれません。 IW:SuikaCVS:"suikawiki/wikidata/suikawiki-config.ph" の最新版を使ってみてください。

また、最初の方に wiki の URI を設定するところがありますから、 ここも適当に直しておきます。

[9] suikawiki-config.ph には他にも色々設定項目がありますが、 とりあえず動かすだけならこれだけでいいはずです。

[8] Plugin を compile します。 lib/SuikaWiki/Plugin で、 perl mkplugin.pl プラグイン名.pm として作っていきます。プラグイン名は同じ directory に入っているプラグイン名.wps というファイルと同じ名前を指定します。 (make があれば、 make プラグイン名.pm でも OK です。将来は make all で出来るようになるかもしれません。) Plugin の compile が終わったら、 *.wps 及び mkplugin.pl, Makefile は削除しても構いません。

最近の CVS 版では、 misc/plugins/ で追加の plugin が提供されています。必要っぽい名前のものは compile しておきましょう。

なお、 plugin によっては他のモジュールや外部命令が必要かもしれません。たとえば、 Image plugin では ImageMagick の convert 命令があるといいです。 (なくてもいいです。形式変換が出来ないだけだから。)

管理者の合言葉

[11] 管理用合言葉を設定します。

なお、この合言葉入力欄は IW:SuikaWiki:WikiPlugin WikiAdmin に含まれています。気になるなら、悪戯を防ぐために plugin の directory からこの plugin (lib/SuikaWiki/Plugin/WikiAdmin.pm) を取り除いておけば欄は表示されません。

WikiPage の用意

[12] 正しく設定出来ていれば (そしてこの WikiPage の記述が古くなっていなければ) 以上でとりあえず動きます。

実用的には更に幾つかの WikiPage を用意する必要があります。

SuikaWiki 2 導入メモ (2003年12月)

[1] SuikaWiki2 を実際に導入してみました。 その時の手順をメモっておきます。 作業内容は概略だけなので、詳細は SuikaWiki//Setup の方を見て下さい。 (内容は古いですけど。)

  1. SuikaWiki の入手== CVS IW:SuikaCVS:"suikawiki/script/" から branch-suikawiki-1 枝の一式を拾ってきて、適当なディレクトリに配置
  2. 設定ファイルの修正
    1. default/ を wikidata/ に rename
    2. wikidata/log/, wikidata/lock/ を一応作っておく。
    3. CVS からbranch-suikawiki-1 枝の IW:SuikaCVS:"suikawiki/wikidata/suikawiki-config.ph" を拾ってきて、 wikidata/ のものを上書き
    4. suikawiki-config.ph の先頭にある自身の URI に関する設定を修正
  3. 外部モジュールの準備
    1. manakai IW:SuikaCVS:"messaging/manakai/" を拾ってきて、 SuikaWiki script から見えるようにする。(SuikaWiki の lib/ に manakai の lib/Message/ をコピれば十分。)
    2. Char::Class IW:SuikaCVS:"perl/charclass/" を拾ってきて、 SuikaWiki script から見えるようにする。 (Char/Class/XML.pm を作って、 SuikaWiki の lib/ にコピれば十分。蝕んだ perl では動かないので、不安なら make test で確認すべし。)
  4. WikiPlugin module 群の comiple
    1. lib/SuikaWiki/Plugin/ 以下にある plugin を compile。なくても動くものもあるが、確認するのが面倒なら全部 compile してしまう。
    2. misc/plugin/ 以下にある plugin を必要に応じて compile。
  5. 初期 WikiPage の準備
    1. Referer plugin を使う場合、 wiki の URI?mycmd=edit;mypage=Wiki//Referer//IgnoreSite をブラウザで開いて、 wiki の URI を加える。 (書式はこの wiki の Wiki//Referer//IgnoreSite を参照されたい。) こうしないと、 wiki 内の移動の Referer が記録されてしまう。
    2. この wiki の WikiPage を参考に、次の WikiPage を用意する。 (面倒なら丸写しでいい。)
      • Wiki//Resource//ja
      • Wiki//Page//Create
      • Wiki//Page//Search
      • Wiki//Style//List//HTML
      • Wiki//Style//SuikaWiki//HTML
      • Wiki//Style//Plugin//HTML
      • Wiki//Style//浮動物//HTML
      • Wiki//MenuBar

これくらいすれば、最低限使えるようになるでしょう。

メモ