#?SuikaWiki/0.9
*SuikaWiki を動かすためのメモ
[1] 以下に書いてある通りに操作すると、 [[SuikaWiki]]
が動くようになる'''可能性があります'''。
** SuikaWiki 及び必要モジュールの入手と導入
[2] 必要なものと入手先一覧:
- [[perl]] : 辺りから探して。
- [[SuikaWiki]] 本体 :
- [[manakai]] :
- [[Char::Class]] :
- [[Jcode.pm]] :
[3] manakai と Char::Class の install は、
それぞれの WikiPage を見て下さい。どちらも pure perl
ですが、 Char::Class は直接使用可能な形式で配布されていないので、
perl module を生成する必要があります。
[WEAK[(一度生成すれば architecture に依存しないので他のサーバーに持っていっても OK。なお、現時点で必要なのは [CODE(perl)[Char::Class::XML]] だけなのでこれ1個作れば十分。)]]
manakai も Char::Class も、他の script
で使用しないのなら、 SuikaWiki の [CODE(file)[lib]]
directory に突っ込めば OK です。
[4] SuikaWiki 本体は、[WEAK[もちろん httpd から見える]]適当な
directory に配置します。
[WEAK[といっても、見える必要があるのは [CODE(file)[wiki.cgi]] だけで、後のファイルは、 [CODE(file)[wiki.cgi]] と [CODE(file)[wikidata/suikawiki-config.ph]] の最初の方にある path を適当に指定すれば、どこにあっても問題ないです。]]
[[#comment]]
** WikiDatabase のための場所の確保
[5] WikiPage database のための場所を用意します。既定値では CGI script
の directory 内の [CODE[wikidata]] という subdirectory
です。新しく作る時は CVS の同じ場所にある [CODE[default]]
という directory の名前を変更します
[WEAK[(この中には最低限必要であろう WikiPage が含まれています)]]。
[7] [CODE(file)[wikidata]] directory 内に、
[CODE(file)[page]], [CODE(file)[lock]],
[CODE(file)[log]] という3つの directory
を作っておきます。これらはそれぞれ、 WikiPage,
lock file, 記録を入れるのに使われます。
[WEAK[(これらを他の場所とか他の名前にしたいときは、 [CODE(file)[suikawiki-config.ph]] で書き換えてください。 [CODE(file)[suikawiki-config.ph]] 以外の書き換えが必要だとしたらそれは不具合なので、報告してください。)]]
[[#comment]]
** 設定ファイル
[6] [CODE(file)[wikidata/suikawiki-config.ph]] は当該 wiki
の設定ファイルです。
>>4 で配置を変更した場合はこのファイル内の経路も正しく設定しないといけません。
''重要'': CVS の [CODE(file)[default/suikawiki-config.ph]]
は古くて使い物にならないかもしれません。
の最新版を使ってみてください。
また、最初の方に wiki の [[URI]] を設定するところがありますから、
ここも適当に直しておきます。
[9] [CODE(file)[suikawiki-config.ph]]
には他にも色々設定項目がありますが、
とりあえず動かすだけならこれだけでいいはずです。
[[#comment]]
[8] Plugin を compile します。 [CODE(file)[lib/SuikaWiki/Plugin]]
で、 [KBD[perl mkplugin.pl プラグイン名.pm]]
として作っていきます。プラグイン名は同じ directory
に入っている[VAR[プラグイン名]].wps というファイルと同じ名前を指定します。
[WEAK[([[make]] があれば、 [KBD[make プラグイン名.pm]] でも OK です。将来は [KBD[make all]] で出来るようになるかもしれません。)]]
[WEAK[Plugin の compile が終わったら、 [CODE[[VAR[*]].wps]] 及び [CODE(file)[mkplugin.pl]], [CODE(file)[Makefile]] は削除しても構いません。]]
最近の CVS 版では、
[CODE(file)[misc/plugins/]] で追加の plugin
が提供されています。必要っぽい名前のものは compile
しておきましょう。
[WEAK[なお、 plugin によっては他のモジュールや外部命令が必要かもしれません。たとえば、 Image plugin では [[ImageMagick]] の [KBD[convert]] 命令があるといいです。 (なくてもいいです。形式変換が出来ないだけだから。)]]
[[#comment]]
** 管理者の合言葉
[11] 管理用合言葉を設定します。
[[#form:'%wiki-admin-change-password();':'':'%output(form=>0);']]
なお、この合言葉入力欄は [CODE[WikiAdmin]]
に含まれています。気になるなら、悪戯を防ぐために plugin の directory からこの plugin
([CODE(filename)[lib/SuikaWiki/Plugin/WikiAdmin.pm]])
を取り除いておけば欄は表示されません。
[[#comment]]
** WikiPage の用意
[12] 正しく設定出来ていれば
[WEAK[(そしてこの WikiPage の記述が古くなっていなければ)]]
以上でとりあえず動きます。
実用的には更に幾つかの WikiPage を用意する必要があります。
-CVS or 本家 SuikaWiki のをそのまま流用すればよいもの
--[[Wiki//Page//Create]]
--[[Wiki//Page//Search]]
--[[IndexPage]]
--[[RecentChanges]]
--[[Wiki//Resource//ja]]
--[[Wiki//Resource//en]]
--[[NewPageTemplate]]
--[[Wiki//Style//List//HTML]]
--[[Wiki//Style//SuikaWiki//HTML]]
--[[Wiki//Plugin//Info]]
--このほか必要に応じて WikiResource//*
-適切な内容で書いておくべきもの
--[[HomePage]]
--[[Wiki//Admin]]
--[[Wiki//News]]
--[[Wiki//Help]]
--[[Wiki//Page//License]]
--[[Wiki//Referer//IgnoreSite]]
-このほか、あると良いもの
--[[SandBox]]
--[[Wiki//Edit//Help]]
--[[Wiki//InterWikiName]]
--[[Wiki//Referer//SiteName]]