PukiWiki/Install の履歴ソース(No.30)

* PukiWikiのインストール(PukiWiki-1.4.4以降) [#w33089a5]

#contents

- 設置の事例
-- [[PukiWiki/Install/Windows]]
-- [[PukiWiki/CGI版PHPで動作させるには]]
-- [[PukiWiki/Install/RedHat]]
-- [[PukiWiki/Install/xrea.com]]
-- [[動作実績]]

** 動作環境 [#aa18d127]
PukiWikiは[[PHP]]で書かれています。日本語マルチバイト対応の[[PHP]]がインストールされている環境なら基本的にどのOS上でも動作します。

日本語マルチバイト対応モジュール([[mbstring]])対応のPHP 4.1.0以降であれば動作するはずです。

※注意: PHP 5.0以降で動作させる場合は、2004/10/18にリリースされた PukiWiki 1.4.4_php5 を使用して下さい

** 前提 [#g4ae511d]

設置方法には複数の選択肢があります。

配布ファイルである tar.gz あるいは zip ファイルをそのまま設置サーバーへ放り込み、サーバー側で解凍、設定を行なうことも出来ますし、ローカルで解凍、設定したのち、FTPでファイル転送を行うことも可能です。

ここでは、もっとも一般的な方法であると思われる

| ローカルで解凍 ==> 設定 ==> FTPで設置サーバーへ転送 ==> パーミッションの確認 |

という手順を説明します。他の方法を選択している場合は、不要な部分を適宜読み飛ばしてください。

また、文字コードや改行コードはデフォルトの「文字コード：EUC-JP、改行コード：LF」としています。


** 配置する前に [#n20fce7c]

FTPでファイルを配置する前に、PukiWikiの設定ファイルpukiwiki.ini.phpを自分の環境に合わせて書き換えておきましょう。いたずらされない様に、少なくとも管理者パスワードはデフォルトでないものに変更して下さい。

*** pukiwiki.ini.php の修正 [#e76fbfcf]

 $modifier = 'anonymous';

上記のanonymousの部分をあなたの名前に書き換えましょう。日本語でもかまいません。

    $modifierlink = 'http://pukiwiki.example.com/';

上記の「http&#x3a;//pukiwiki.example.com/」の部分をあなた(あなたのPukiWikiを管理している人)のWebサイトのURLに書き換えましょう。PukiWikiを設置するURLでなくてかまいません。あなたのWebのトップページのURLにしておきましょう。

 $adminpass = '{x-php-md5}!';

上記の「{x-php-md5}!」の部分を書き換えます。

MD5による暗号化したパスワードを書き込む必要がありますが、とりあえずは

    $adminpass = '{x-php-md5}' . md5('your-pasword');

といった形式でyour-paswordの部分をあなたが決めた別のパスワードに書き換えて記述しておきましょう。正式にPukiWikiを使い続けることを決めてから、MD5によって暗号化した文字列に書き換えればいいです。

MD5ハッシュは、Linuxやcygwinであれば以下のようにして計算させる事ができます。('-n' オプションを忘れずに!)

     $ echo -n 'pass' | md5sum

確実を期すなら、管理者パスワードは

     $ echo -n 'himitsu' | md5sum
     f1a0e73e5d7fc293952d380e32fda73c -
     
     $adminpass = '{x-php-md5}f1a0e73e5d7fc293952d380e32fda73c'; // md5('himitsu')

のように設定するのがベストです。~
当然、himitsuは別のパスワードに書き換えて暗号化した文字列を生成し、~
それを設定してください。~
FreeBSDなどでは md5sum の代わりに md5 コマンドを使ってください。

以上、pukiwiki.ini.phpの中の3ヶ所の書き換えが終わったら、いよいよインストールしましょう。

くれぐれもファイル転送モードとパーミッションの設定は間違わないように。また、UNIX系の場合には、オーナー(ファイルの所有者が誰なのか)に関しても適切に設定して下さい。([[PukiWiki/ファイルのパーミッション設定]]のコマンド例を参考にして下さい)

なお、配布時は pukiwiki.php、index.php のどちらにアクセスしても同じデータが表示される様になっています。どちらか一方が不要であれば消してしまってもかまいません。また、名前を別のもの(たとえば wiki.phpなど)に変更してもかまいません。


** FTPで設置する時の注意事項 [#de49eda2]

FTPそのものやFTPクライアントに関する情報は他にまかせるとして、下記を参考にFTPクライアントの設定を確認しておいてください。

*** ファイル転送モード [#fb12059c]

- バイナリモード(binary mode)で転送するもの:
-- 画像ファイル「*.gif、*.png」

- アスキーモード(ascii mode)で転送するもの:
-- 画像ファイル以外のファイル「*.php、*.txt、*.lng、*.css、*.js」


*** 文字コードと改行コードの変換 [#m16862ce]

使用するFTPクライアントによっては、ファイル転送時に文字コードや改行コードを変換しながら転送する機能が搭載されている場合があります。ローカル編集したファイルをコードの違うサーバーへ転送する時は重宝する機能ですが、今回のような初期の設置時には注意が必要です。

バイナリーファイルである画像「*.gif、*.png」以外の「*.php、*.txt」等のアスキーファイルは、「文字コード：EUC-JP、改行コード：LF」となっています。これらは、このまま設置した場合に動作するよう調整していますので、''無変換''転送を行なってください。

** PukiWikiのファイル一覧 [#s94ea60b]

:|
~PukiWikiで必要なディレクトリとファイルは次のとおりです。パーミッションと転送モードの別を色分けして表示しています。

|&color(red){ディレクトリ};    | 755|　        |
|&color(maroon){ディレクトリ}; | 777|        　|
|&color(blue){ファイル};       | 644|ASCII(EUC)|
|&color(forestgreen){ファイル};| 644|Binary    |
|&color(fuchsia){ファイル};    | 666|ASCII(EUC)|
|ディレクトリ・ファイル        |不要|        　|

-- &color(red){(755)./};
-- &color(blue){(644/ASCII).htaccess};
-- &color(blue){(644/ASCII)en.lng};
-- &color(blue){(644/ASCII)ja.lng};
-- &color(blue){(644/ASCII)default.ini.php};
-- &color(blue){(644/ASCII)index.php};
-- &color(blue){(644/ASCII)keitai.ini.php};
-- &color(blue){%%(644/ASCII)pukiwiki.php%%};
-- &color(blue){(644/ASCII)pukiwiki.ini.php};
-- &color(blue){(644/ASCII)rules.ini.php};
-- COPYING.txt
-- README.txt
-- README.en.txt
-- UPDATING.txt
-- UPDATING.en.txt

-- &color(maroon){(777)''./attach''};
--- &color(blue){(644/ASCII).htaccess};
--- &color(blue){(644/ASCII)index.html};

--　&color(maroon){(777)''./backup''};
--- &color(blue){(644/ASCII).htaccess};
--- &color(blue){(644/ASCII)index.html};

-- &color(maroon){(777)''./cache''};
--- &color(fuchsia){(666)recent.dat};
--- &color(fuchsia){(666)autolink.dat};
--- &color(fuchsia){(666)entities.dat};
--- &color(fuchsia){(666)*.ref};
--- &color(fuchsia){(666)*.rel};
--- &color(blue){(644/ASCII).htaccess};
--- &color(blue){(644/ASCII)index.html};

-- &color(maroon){(777)''./counter''};
--- &color(blue){(644/ASCII).htaccess};
--- &color(blue){(644/ASCII)index.html};

-- &color(maroon){(777)''./diff''};
--- &color(blue){(644/ASCII).htaccess};
--- &color(blue){(644/ASCII)index.html};

-- &color(red){(755)''./image''};
--- &color(forestgreen){(644/Bin)pukiwiki.gif};
--- &color(blue){(644/ASCII)index.html};
--- &color(forestgreen){(644/Bin)add.png};
--- ahl-good.png
--- b_pukiwiki.dev.png
--- b_pukiwiki.org.png
--- &color(forestgreen){(644/Bin)backup.png};
--- &color(forestgreen){(644/Bin)copy.png};
--- &color(forestgreen){(644/Bin)diff.png};
--- &color(forestgreen){(644/Bin)edit.png};
--- &color(forestgreen){(644/Bin)file.png};
--- &color(forestgreen){(644/Bin)freeze.png};
--- &color(forestgreen){(644/Bin)help.png};
--- &color(forestgreen){(644/Bin)list.png};
--- &color(forestgreen){(644/Bin)new.png};
--- &color(forestgreen){(644/Bin)pukiwiki.png};
--- &color(forestgreen){(644/Bin)recentchanges.png};
--- &color(forestgreen){(644/Bin)reload.png};
--- &color(forestgreen){(644/Bin)rename.png};
--- &color(forestgreen){(644/Bin)rss.png};
--- &color(forestgreen){(644/Bin)search.png};
--- skin.png
--- &color(forestgreen){(644/Bin)top.png};
--- &color(forestgreen){(644/Bin)unfreeze.png};
--- valid-xhtml10.png
--- valid-xhtml11.png
--- vcss.png

-- &color(red){(755)''./image/face''};
--- &color(blue){(644/ASCII)index.html};
--- &color(forestgreen){(644/Bin)bigsmile.png};
--- &color(forestgreen){(644/Bin)heart.png};
--- &color(forestgreen){(644/Bin)huh.png};
--- &color(forestgreen){(644/Bin)oh.png};
--- &color(forestgreen){(644/Bin)sad.png};
--- &color(forestgreen){(644/Bin)smile.png};
--- &color(forestgreen){(644/Bin)wink.png};
--- &color(forestgreen){(644/Bin)worried.png};

-- &color(red){(755)''./lib''};
--- &color(blue){(644/ASCII).htaccess};
--- &color(blue){(644/ASCII)index.html};
--- &color(blue){(644/ASCII)auth.php};
--- &color(blue){(644/ASCII)backup.php};
--- &color(blue){(644/ASCII)config.php};
--- &color(blue){(644/ASCII)convert_html.php};
--- &color(blue){(644/ASCII)diff.php};
--- &color(blue){(644/ASCII)file.php};
--- &color(blue){(644/ASCII)func.php};
--- &color(blue){(644/ASCII)html.php};
--- &color(blue){(644/ASCII)init.php};
--- &color(blue){(644/ASCII)link.php};
--- &color(blue){(644/ASCII)mail.php};
--- &color(blue){(644/ASCII)make_link.php};
--- &color(blue){(644/ASCII)mbstring.php};
--- &color(blue){(644/ASCII)plugin.php};
--- &color(blue){(644/ASCII)proxy.php};
--- &color(blue){(644/ASCII)pukiwiki.php};
--- &color(blue){(644/ASCII)trackback.php};

-- &color(red){(755)''./plugin''};
--- &color(blue){(644/ASCII).htaccess};
--- &color(blue){(644/ASCII)index.html};
--- &color(blue){(644/ASCII)add.inc.php};
--- &color(blue){(644/ASCII)aname.inc.php};
//1.4で削除---&color(blue){(644/ASCII)anchor.inc.php};
--- &color(blue){(644/ASCII)article.inc.php};
--- &color(blue){(644/ASCII)attach.inc.php};
--- &color(blue){(644/ASCII)back.inc.php};
--- &color(blue){(644/ASCII)backup.inc.php};
--- &color(blue){(644/ASCII)br.inc.php};
--- &color(blue){(644/ASCII)bugtrack.inc.php};
--- &color(blue){(644/ASCII)bugtrack_list.inc.php};
--- &color(blue){(644/ASCII)calendar.inc.php};
--- &color(blue){(644/ASCII)calendar_edit.inc.php};
--- &color(blue){(644/ASCII)calendar_read.inc.php};
--- &color(blue){(644/ASCII)calendar_viewer.inc.php};
--- &color(blue){(644/ASCII)calendar2.inc.php};
--- &color(blue){(644/ASCII)clear.inc.php};
--- &color(blue){(644/ASCII)color.inc.php};
--- &color(blue){(644/ASCII)comment.inc.php};
--- &color(blue){(644/ASCII)counter.inc.php};
--- &color(blue){(644/ASCII)deleted.inc.php};
--- &color(blue){(644/ASCII)diff.inc.php};
--- &color(blue){(644/ASCII)edit.inc.php};
--- &color(blue){(644/ASCII)filelist.inc.php};
--- &color(blue){(644/ASCII)freeze.inc.php};
--- &color(blue){(644/ASCII)hr.inc.php};
--- &color(blue){(644/ASCII)img.inc.php};
--- &color(blue){(644/ASCII)include.inc.php};
--- &color(blue){(644/ASCII)includesubmenu.inc.php};
--- &color(blue){(644/ASCII)insert.inc.php};
--- &color(blue){(644/ASCII)interwiki.inc.php};
--- &color(blue){(644/ASCII)links.inc.php};
--- &color(blue){(644/ASCII)list.inc.php};
--- &color(blue){(644/ASCII)lookup.inc.php};
--- &color(blue){(644/ASCII)ls.inc.php};
--- &color(blue){(644/ASCII)ls2.inc.php};
--- &color(blue){(644/ASCII)map.inc.php};
--- &color(blue){(644/ASCII)md5.inc.php};
--- &color(blue){(644/ASCII)memo.inc.php};
--- &color(blue){(644/ASCII)menu.inc.php};
--- &color(blue){(644/ASCII)navi.inc.php};
--- &color(blue){(644/ASCII)new.inc.php};
--- &color(blue){(644/ASCII)newpage.inc.php};
--- &color(blue){(644/ASCII)norelated.inc.php};
--- &color(blue){(644/ASCII)online.inc.php};
--- &color(blue){(644/ASCII)paint.inc.php};
--- &color(blue){(644/ASCII)pcomment.inc.php};
--- &color(blue){(644/ASCII)popular.inc.php};
--- &color(blue){(644/ASCII)random.inc.php};
--- &color(blue){(644/ASCII)read.inc.php};
--- &color(blue){(644/ASCII)recent.inc.php};
--- &color(blue){(644/ASCII)ref.inc.php};
--- &color(blue){(644/ASCII)referer.inc.php};
--- &color(blue){(644/ASCII)rename.inc.php};
--- &color(blue){(644/ASCII)rss.inc.php};
--- &color(blue){(644/ASCII)rss10.inc.php};
--- &color(blue){(644/ASCII)ruby.inc.php};
--- &color(blue){(644/ASCII)search.inc.php};
--- &color(blue){(644/ASCII)server.inc.php};
--- &color(blue){(644/ASCII)setlinebreak.inc.php};
--- &color(blue){(644/ASCII)showrss.inc.php};
--- &color(blue){(644/ASCII)size.inc.php};
--- &color(blue){(644/ASCII)source.inc.php};
--- &color(blue){(644/ASCII)tb.inc.php};
--- &color(blue){(644/ASCII)template.inc.php};
--- &color(blue){(644/ASCII)topicpath.inc.php};
--- &color(blue){(644/ASCII)touchgraph.inc.php};
--- &color(blue){(644/ASCII)tracker.inc.php};
--- &color(blue){(644/ASCII)tracker_list.inc.php};
--- &color(blue){(644/ASCII)unfreeze.inc.php};
--- &color(blue){(644/ASCII)update_entities.inc.php};
--- &color(blue){(644/ASCII)version.inc.php};
--- &color(blue){(644/ASCII)versionlist.inc.php};
--- &color(blue){(644/ASCII)vote.inc.php};
--- &color(blue){(644/ASCII)yetlist.inc.php};
--- readme.ja.txt

-- &color(red){(755)''./skin''};
--- &color(blue){(644/ASCII)default.en.css};
--- &color(blue){(644/ASCII)default.ja.css};
--- &color(blue){(644/ASCII)print.en.css};
--- &color(blue){(644/ASCII)print.ja.css};
--- &color(blue){(644/ASCII)trackback.css};
--- &color(blue){(644/ASCII).htaccess};
--- &color(blue){(644/ASCII)index.html};
--- &color(blue){(644/ASCII)default.js};
--- &color(blue){(644/ASCII)trackback.js};
--- &color(blue){(644/ASCII)keitai.skin.ja.php};
--- &color(blue){(644/ASCII)pukiwiki.skin.en.php};
--- &color(blue){(644/ASCII)pukiwiki.skin.ja.php};

-- &color(maroon){(777)''./trackback''};
--- &color(blue){(644/ASCII).htaccess};
--- &color(blue){(644/ASCII)index.html};

-- &color(maroon){(777)''./wiki''};
--- &color(blue){(644/ASCII).htaccess};
--- &color(blue){(644/ASCII)index.html};
--- &color(fuchsia){(666)…….txt};

-- &color(maroon){(777)''./wiki.en''};
--- &color(blue){(644/ASCII).htaccess};
--- &color(blue){(644/ASCII)index.html};
--- &color(fuchsia){(666)…….txt};


** 動作確認 [#l60e824e]

index.php%%pukiwiki.php%%にブラウザからアクセスしてデフォルトページが表示できれば、基本的に設置は完了です。

念の為、以下の機能が正常に機能する事を確認しましょう。
- ページの編集ができること (FrontPageなど、凍結されていないページについて)
-- ※編集時に Runtime Errorが出る場合、更新されるファイルのパーミッションや、それらを収めているディレクトリのパーミッションを確認して下さい
- ページの新規作成、および削除ができること
-- ※Runtime Errorが出る場合、wiki/ ディレクトリのパーミッションを確認して下さい

試したことがなければ、以下の操作もやってみましょう。
- ページの凍結、および凍結解除ができること(設定したパスワードが必要です)
-- 凍結したファイルが編集できないこと
- articleあるいはvoteプラグインで記事の投稿、投票ができること


** PukiWikiのカスタマイズ [#z7f60bba]

めでたく設置に成功したら、PukiWikiを自分好みにカスタマイズしていきましょう。

*** pukiwiki.ini.php の調整 [#j22a668f]

「インストールする前に」で行なった設定以外に pukiwiki.ini.php の気になる項目があれば調整してみて下さい。


- トップページの名前

注意 : 1.3系列とは異なり、トップページ名に日本語を使う場合でもBracketNameにしないでください。
    $defaultpage = "フロントページ";

- サイトのタイトル

ブラウザのタイトルバーに表示される名前です。
    $page_title = "フロントページ";


*** MenuBarの活用 [#r81f37be]

初期状態では、「最近のxx件」という表示と共に日付とWikiNameがずらっと左側に並んでいるはずです。ページが新規作成／更新されれば、新たにWikiNameが増えたり、すでに表示されてあったWikiNameの上下位置が入れ替わったりと自動で変化しますので、表示されているWikiNameをクリックしさえすれば、自由に閲覧することが可能です。

もちろん、この初期状態のままでも使用に問題はありませんが、せっかくですからメニューの作成などをしてみてはいががでしょうか？

とにもかくにも編集するためにMenuBarへと辿り着かなければ始まりません。「最近のxx件」という表示の中にMenuBarというWikiNameがあればそこから辿れます。無ければ、上部メニューの「単語検索」をクリックして

:|
    MenuBar

と打ち込み検索すれば、見付かるはずです。

ここまで辿り着いたら後は簡単。通常の編集となにも変わりませんので、自分好みにカスタマイズして下さい。

その他、[[ちょっと便利に]]のページでは改造／活用のヒントが紹介されています。

*** スキンやCSSの改造による外観の変更 [#k403ec4d]

ページ左上のアイコンは image/pukiwiki.png を置き換えればOKです。

参考までに: 標準添付のアイコンのサイズは 80 x 80 Pixelです。


*** プラグインやカスタマイズによる機能追加 [#we9bce3a]

設置が正常に完了して、サイトの外観も決まったら、実際に色々なページを作ってみます。

しばらく使っていくうちに欲しい機能や実現したい動作ができた場合は[[FAQ]]、[[質問箱]]、[[自作プラグイン]]に目を通してみてください。

ページの構成などで迷った場合は、他のPukiWikiサイトを[[リンク集>PukiWiki/関連リンク集]]や検索エンジンで見てみる（[[google:PukiWiki]]）と参考になるかもしれません。

*** 順調に稼動できたら [#u8986100]

設置が完了して、順調に運用できた場合は[[PukiWiki使用者への100?の質問>Use PukiWiki]]に答えてみて下さいませ。

-----------------------------------------
* PukiWiki 1.3系から1.4への移行 [#wa211a3d]

:&color(crimson){【注意】};|
PukiWiki 1.3系から1.4へ移行する前に、ほんとうにご自分のサイトで1.4の機能が必要かどうか検討した上で移行しましょう。1.3系の機能で十分であるならば、あえて1.4に移行する必要はありません。~
PukiWiki 1.3系は1.4が正式リリースされた後も、セキュリティ関係のバグフィックスなどのサポートは継続して行ないます(新機能の追加は行ないません)。

** バックアップ [#t32f8a00]

バックアップは非常に大切です。以下の作業を行う前に、*.phpやスキン、プラグイン、attach、backup、counter、diff、wikiディレクトリを含む全てのデータをバックアップしてください。(やり方はお任せします :) )

** 1.4のインストール [#m575e50b]

- wikiディレクトリ以外のファイルをアップロード

::【補足】|1.4ではDOCTYPEがXHTML 1.1に移行しています。自作のスキンやプラグインを引き続き使用する場合は、XHTML 1.1の書式に書き換える必要があります。
~また、プラグインについては1.3系列のプラグインをそのまま使用できるとはかぎりません([[プラグイン/開発者向け>dev:プラグイン/開発者向け#changes]]参照)。標準のプラグインは1.4に添付されたものをインストールしてください。

::【注意】|1.4ではcacheディレクトリ、trackbackディレクトリが追加されています。ここのパーミッションの設定（ディレクトリは777、*.datは666）を忘れると下記のページ変換時にエラーが出ます。

** ファイル名からBracket部分を取り去る [#fd5c3754]
- stripbracket.inc.phpをpluginディレクトリにインストール [[配布場所>dev:PukiWiki/1.4/1.3系からの移行]]
- http：//.../pukiwiki.php?plugin=stripbracketを実行
- pluginディレクトリのstripbracket.inc.phpを削除

** リンクキャッシュを初期化する [#ofd043da]
- http：//.../pukiwiki.php?plugin=linksを実行

//**1.3のwikiデータを削除
//-1.4が正常に動作し、もう1.3に戻す必要がないと確証が得られたら、wikiディレクトリ内の*.bakファイルを削除する。
//-削除しなくても1.4の運用には影響がないので、確証が得られるまで残しておけばよい。

** 書式の違いをコンバート [#p901a9ca]

書式の移行を手動で行う場合は、このステップを省略できます。

//-[[しろくろのへや:conv/書式コンバータ]]でconv.inc.phpをダウンロード
//-pluginディレクトリにconv.inc.phpをインストール
//-http：//.../pukiwiki.php?plugin=convを実行
//-pluginディレクトリのconv.inc.phpを削除
- convertpage.inc.phpをpluginディレクトリにコピー [[配布場所>dev:PukiWiki/1.4/1.3系からの移行]]
- http：//.../pukiwiki.php?plugin=convertpageを実行
- pluginディレクトリのconvertpage.inc.phpを削除

::【補足】|従来ユーザー定義だったcolor,sizeなどを[[インライン型プラグイン]]に変換はしません。但し、ユーザー定義のcolorやsizeを&～;の形式で定義していた場合は、そのままインラインプラグインで解釈されるようになりますので書き換えは不要です((1.4ではユーザー定義はrules.ini.phpで定義します。))。
~ユーザー定義のcolorやsizeを&～;の形式とは異なる形で定義していた場合は、従来のユーザー定義をそのまま残しておけば書き換えは不要です((1.4ではユーザー定義はrules.ini.phpで定義します。))。
~aname、counter、online、versionは[[インライン型プラグイン]]に移行しています。convertpage.inc.phpではこれらをコンバートしませんので、aname以外は書き換えが必要です。


* PukiWiki 1.4.3以前から1.4.4以降への移行 [#qdcf73ed]

** PukiWiki1.4.4で何が起こったか [#b9edb5be]

PukiWiki 1.4.3→1.4.4の改訂の過程で機能追加・ロジックの整理・バグ取りもさることながら、大掛かりなファイル配置の整理が行われています。

ここではPukiWiki1.4.3以前の版をお使いの方への変更概要＋移行方法を紹介します。
なお、1.3.x系をお使いの方は[[../1.3系からの移行]]も併せてお読みください。


** まずはバックアップ [#j082a303]
例によってバックアップは非常に大切です。以下の作業を行う前に、*.phpやスキン、プラグイン、attach,backup,counter,diff,wikiディレクトリを含む全てのデータをバックアップしてください。(やり方はお任せします :) )

** ファイルの配置整理 [#oeaa275a]
*** 配置が変更された理由について [#g4fe1343]

+ PukiWikiの各フォルダのディレクトリ配置は定数宣言されているのですが、推奨設定以外を設定するとうまく動かないなど徹底されておらず、懸案事項として挙げられていました（[[dev:BugTrack/147]],[[dev:BugTrack/480]],[[dev:BugTrack/509]]）。
更に [[dev:PukiWiki/WikiFarm]] や [[dev:PukiWiki/国際化]] の議論もあり、ファイル配置の整理が必要との判断から大幅な配置変更が行われました。
+ 従来携帯電話への対応はi-mode, J-Phone限定でしたが au,TU-KA,AirH" Phoneなど未対応のキャリアやNetFrontといった組み込みブラウザに対応しました。~
従来は対応ブラウザ毎に設定ファイルを作成していましたが、対応ブラウザが増えると管理が煩雑になるため、設定ファイルの統合が行われました。
+ その他、主だった対応内容のリンク先
++ デバイス/ユーザーエージェント ハンドリングの単純化 - [[dev:開発日記/2004-07-05]]
++ 各ディレクトリにindex.htmlを追加 - [[dev:開発日記/2004-07-11]]
++ エントリ用のpukiwiki.php(index.php)を作成 - [[dev:開発日記/2004-07-24]]
++ pukiwiki.png/gif を IMAGE_DIR (./image/) に移動 - [[dev:開発日記/2004-07-24]]
++ face 画像を face/ から image/face に移動 - [[dev:開発日記/2004-07-28]]
++ ライブラリとして使われうる phpファイル を全て LIB_DIR (lib/) に移動 - [[dev:開発日記/2004-08-01]]


*** 各ファイルの移動元・移動先一覧 [#gcd18878]
1.4.3以前→1.4.4 のファイルの移動元・移動先をまとめた一覧です。一旦は読み飛ばして、移行作業時に参照して下さい。。

|移動元dir|ファイル名|移動先dir|h
|(なし)|index.html|追加 -> ./lib((1.4.4で新規に追加されたフォルダです。パーミッションはpluginディレクトリと同じにしてください))|
|~     |.htaccess |~|
|./    |auth.php  |移動 -> ./lib|
|~     |backup.php|~|
|~     |config.php|~|
|~     |convert_html.php|~|
|~     |diff.php  |~|
|~     |file.php  |~|
|~     |func.php  |~|
|~     |html.php  |~|
|~     |init.php  |~|
|~     |link.php  |~|
|~     |mail.php  |~|
|~     |make_link.php|~|
|~     |mbstring.php|~|
|~     |plugin.php|~|
|~     |proxy.php |~|
|~     |pukiwiki.php|~|
|~     |trackback.php|~|
|~     |pukiwiki.gif|移動 -> ./image|
|~     |pukiwiki.png|~|
|~     |i_mode.ini.php|削除 -> keitai.ini.phpに統合|
|~     |jphone.ini.php|~|
|~     |*.lng|変更なし|
|~     |*.ini.php|~|
|(なし)|keitai.ini.php|追加 -> ./|
|(なし)|pukiwiki.php|追加((来訪者のエントリ用となるプログラムであり、/libにあるpukiwiki.phpとは別物である点に注意。従来pukiwiki.phpをindex.phpにしており、今後もpukiwiki.phpでアクセス不要の場合は不要)) -> ./ |
|(なし)|index.php|追加((来訪者のエントリ用となるプログラム。pukiwiki.phpでのみアクセスを許す人は不要)) -> ./|
|./face|*|移動 -> ./image/face へ|
|(なし)|worried.png|追加 -> ./image/face|
|./plugin|dir.txt|削除|
|(なし)|index.html|追加 -> ./plugin|
|~     |.htaccess|~|
|~     |clear.inc.php|追加 -> ./plugin((1.4.3で追加されたファイルです。1.4.2以前を使っている方のみ該当))|
|~     |setlinebreak.inc.php|~|
|~     |topicpath.inc.php|~|
|./attach|*|基本変更なし((pukiwikiの動作に直接関係はしませんが、dir.txtが削除されてindex.html, .htaccessが追加されています))|
|./backup |~|~|
|./cache  |~|~|
|./counter|~|~|
|./diff   |~|~|
|./image  |~|~|
|./skin   |~|~|
|./trackback|~|~|
|./wiki   |~|~|
|./wiki.en|~|~|
|./devel  |~|削除((pukiwikiの動作には必要ないので、実運用環境には作成していないと思いますが、一応))|
|./       |*.txt|変更なし((pukiwikiの動作には必要ないので、実運用環境には作成していないと思いますが、一応))|


** 移行の手順 [#a2313675]

*** CVSを使う方法 [#w92e2f20]

LIB_DIR (./lib/) に移動したファイルに関して： お手元でこれらのファイルをカスタマイズされており、CVSを用いてマイグレートされる方のために、移動前の最後のバージョンに、タグ ''pkwk14_2004-08-01_moved-before'' を打ってあります。このタグを(移動前の最新の状態に)マージするためのターゲットにお使い下さい。

*** CVSを使わない方法 [#v88cb313]
方法はいろいろありますが、あくまで一例として。

ファイルの移動以外にもPukiWiki1.4.4のバージョンアップにおいて、ソースコードの大幅な整理が行われています。

さて、ここで質問。あなたはどの程度、配布ファイルに対してプログラムの修正を行いましたか？

もし、ほとんど修正を行っていない場合は、新規にPukiWiki1.4.4をインストールする方法をお勧めします。このとき、万一インストールに失敗しても、今まで使っていたPukiWikiに影響を与えないように、今使っているPukiWikiとは別のディレクトリにインストールするのをお勧めします。

PukiWiki1.4.4で正常に稼動できた事を確認した後にバックアップからattach、backup、cache、diff、trackback、wiki、skinの全ファイルを復元してください。それできっと動く事と思います。

もし、あなたがプログラムの修正をたっぷり行っていた場合は、きっとうんざりするぐらいのソースコードの差異が出ることでしょう。

そこで、一旦あなたが変更した箇所を特定してから、同じような修正をPukiWiki1.4.4に加えていく作業を行っていきます。

+ CVSから1.4.4と最後に自分が持ってきた版に一番近い版を持ってきましょう。[[CVS>http://cvs.sourceforge.jp/cgi-bin/viewcvs.cgi/pukiwiki/]]の一番下のタグを切り替えてた後にDownloadを選びます。
+ 自分のPukiWikiとCVSのファイルとのdiffを取り、自分が変更した箇所を特定して、控えておきます。
+ PukiWiki1.4.4のファイルを適当のディレクトリに展開して、自分のPukiWikiからattach、backup、cache、counter、diff、trackback、wiki を全てコピーする。
+ PukiWiki1.4.4のファイルに対して自分が変更した箇所、パッチを当てた箇所を反映します。もし1.4.4用のパッチがあるのならそれを使った方が良いでしょう。
++ 書き換えるファイルは主に*.ini.php、lib/ や plugin/ が中心だと思いますが skin/ などもお忘れなく。
+ 独自プラグインや自分で作ったフェイスマークなど、配布ファイルに含まれていないものを追加する。
+ 配布ファイルに含まれているファイルで不要なものを削除する。
++ *.txtや、imageの中の画像、devel、初期状態で用意されているページ、使わないプラグインなど必要に応じて、適宜削除する。


--------------------------------------------------------------------------------

            
Site admin: PukiWiki Developers Team
PukiWiki 1.4.6 Copyright © 2001-2006 PukiWiki Developers Team. License is GPL.
Based on "PukiWiki" 1.3 by yu-ji. Powered by PHP 4.4.4-8+etch4. HTML convert time: 0.232 sec.