SuikaWiki3//SuikaWiki2からの移行

SuikaWiki 2 から SuikaWiki 3 への移行の手引き

[1] まず、 SuikaWiki3//Setup などを参考に、 SuikaWiki 3 を用意します。

[2] 古い SuikaWiki 2 の WikiDatabase (wikidata/page/*) の中身を新しい SuikaWiki 3 の WikiDatabase (wikidata/page/*) に複製します。

ディレクトリ *.ns とファイル *.txt はそのまま使用できますが、特性データベースのファイル mt--*.dat はそのままでは使用できません。

mt--41646D696E50617373776F7264.dat: SuikaWiki 2 の管理者用合言葉を記録するデータベースですが、 SuikaWiki 3 には相当する機能がありません。このファイルは削除してください。 (将来 SuikaWiki 3 で認証機能が実装される時には、 SuikaWiki 2 とは互換性のない方法を使用する予定です。)
mt--497346726F7A656E.dat: SuikaWiki 2 で WikiPage の凍結状態を記録するデータベースですが、 SuikaWiki 3 で相当する機能は実装していません。 (将来 SuikaWiki 3 で認証機能が実装される時には、もし要望があれば変換器を提供するかもしれません。)
mt--4C6173744D6F646966696564.dat: SuikaWiki 2 で WikiPage の最終更新日時を記録していたデータベースですが、 SuikaWiki 3 ではファイル名が変更されました。 mv mt--4C6173744D6F646966696564.dat mt--6C6173745F6D6F646966696564.dat としてください。
mt--52656665726572.dat: 参照子情報 (逆リンク URI) を記録するデータベースですが、 SuikaWiki 3 では書式が変更されました。 bin/referer2to3.pl を使って変換できますが、この作業は後で行ってください。。

設定用スクリプト suikawiki-config.ph の内容は全面的に改められましたので、 SuikaWiki 2 用のものは使用できません。 SuikaWiki 3 用のものに置換えてください。

なお、 SuikaWiki 3 の suikawiki-config.ph は、通常は一切書換えずに既定値のまま使用できます。 (以前のように自分自身の URI を指定する必要はありません。)

SuikaWiki 2 の suikawiki-config.ph の後半にあった WikiView の customize は、 SuikaWiki 3 では config.wp2 に記述し、 make config.ph する必要があります。 WikiView の仕様は大きく変更されているので、以前のものはそのままではまず動かないでしょう。

[3] SuikaWiki 2 の特別な WikiPage の幾つかは名前が変わっています。また、内容の記述方法が変わったものもあります。 SuikaWiki 3 のものを基に、必要なら修正してお使いください。

WikiName は変わっていないが、内容を修正する必要のあるもの:

Wiki//Page//Create, Wiki//Page//Search: 入力箱の指定方式が変わったので、その部分を新しい物に差し替える必要があります。
Wiki//Resource//ja, Wiki//Resource//en: 多くの語が追加されているので、新しい物に差し替えてください。
Wiki//InterWikiName: 書式が変わりました。

WikiName が変わったもの:

Wiki//NewPageTemplate: 旧名 NewPageTemplate。内容はそのままお使いいただけます。
Wiki//Style//List//text/html: 旧名 Wiki//Style//List//HTML。書式も変わりました。
Wiki//Referer//IgnoreSite, Wiki//Referer//SiteName: Wiki//InterWikiName に統合されました (書式も変わっています)。古い物は削除してください。

また、特にこだわりがなければ、スタイル・シートも新しい物に入れ替えてください。

[4] 参照子 (逆リンク) データベースを新しい書式に変換します。 perl referer2to3.pl --input-file=mt--52656665726572.dat --output-file=referer.db としてください。変換後に mt--52656665726572.dat は削除してください。

(この作業は >>3 で Wiki//InterWikiName を新しい物に修正した後から行わないと、 wiki 内での移動まで記録されてしまいます。

[5] 以上で SuikaWiki 3 に更新した wiki の準備が整いました。

..//SuikaWiki2からの変更点もお読みください。

BugTrack WikiPlugin Module

[9] バグ追跡システム (BugTrack WikiPlugin module) で新しいバグの WikiPage を追加する form のための整形規則の入力欄名 (POST される際の引数の名前) が変わりましたので、そのままでは使えません。

%bt--create-new-bug の引数 content の内容がこれに影響します。 BugTrack plugin にある記述を参考に修正するか、 content 引数を消去してください。 (SuikaWiki 3 版 %bt--create-new-bug は content 引数が無い場合は資源を参照します。)