PukiWiki1.4.4のインストール†
このページはofficial:PukiWiki/インストールの該当個所の差し替え用です。1.4.3以前の記述は./~1.4.3 に移しました
ページ差し替えの方法†
- 案
- org にPukiWiki/インストール/1.4.3以前, PukiWiki/インストール/1.4.4以降 のページを作る
- ~1.4.3以前 には今までの ~1.4系列 の内容をそのままコピーする
- ~1.4.4以降は~1.4系列の内容に1.4.4での変更を反映した内容で書く
- PukiWiki/インストール/1.4系列は、~1.4.3以前, ~1.4.4以降へのリンクだけ残す
コメントはこのページの一番下にあります
PukiWiki1.4のインストール†
動作環境†
PukiWikiはPHPで書かれています。日本語マルチバイト対応のPHPがインストールされている環境なら基本的にどのOS上でも動作します。
日本語マルチバイト対応モジュール(mbstring)対応のPHP 4.1.0以降であれば動作するはずです。
PHP 5.0以降での動作はdev:BugTrack/632にて検証中です。
設置方法には複数の選択肢があります。
配布ファイルである tar.gz あるいは zip ファイルをそのまま設置サーバーへ放り込み、サーバー側で解凍、設定を行なうことも出来ますし、ローカルで解凍、設定したのち、FTPでファイル転送を行うことも可能です。
ここでは、もっとも一般的な方法であると思われる
ローカルで解凍 ==> 設定 ==> FTPで設置サーバーへ転送 |
をインストール手順として説明しています。他の方法を選択している場合は適宜読み変えてください。
また、文字コードや改行コードはデフォルトの「文字コード:EUC-JP、改行コード:LF」としています。
インストールする前に†
インストールする前に、PukiWikiの設定ファイルpukiwiki.ini.phpを自分の環境に合わせて書き換える必要があります。
試験的にインストールする場合でも、最低限、書き換えなければならない項目があります。
- pukiwiki.ini.php
// 編集者の名前(自由に変えてください)
$modifier = 'me';
上記のmeの部分をあなたの名前に書き換えましょう。日本語でもかまいません。
// 編集者のホームページ(自由に変えてください)
$modifierlink = 'http://change me!/';
上記のhttp://change.me!/の部分をあなたのWebサイトのURLに書き換えましょう。PukiWikiを設置するURLでなくてかまいません。あなたのWebのトップページのURLにしておきましょう。
// 凍結解除用の管理者パスワード(MD5)
// pukiwiki.php?md5=pass のようにURLに入力し
// MD5にしてからどうぞ。面倒なら以下のように。
// $adminpass = md5("pass");
// 以下は pass のMD5パスワードになってます。
$adminpass = "21232f297a57a5a743894a0e4a801fc3";
上記の"21232f297a57a5a743894a0e4a801fc3"の部分を書き換えます。MD5による暗号化したパスワードを書き込む必要がありますが、とりあえずは $adminpass = md5("pass"); の形式でpassの部分を書き換えて記述しておきましょう。正式にPukiWikiを使い続けることを決めてから、MD5によって暗号化した文字列に書き換えればいいです。
以上、pukiwiki.ini.phpの中の3ヶ所の書き換えが終わったら、いよいよインストールしましょう。
くれぐれもファイル転送モードとパーミッションの設定は間違わないように。また、UNIX系の場合には、オーナーに関しても適切に設定して下さい。*1
なお、配布時はpukiwiki.php、index.phpのどちらでもアクセス可能となっています。どちらか一方が不要であれば消してしまってもかまいません。また、別の名前(たとえば wiki.phpなど)に変更してもかまいません。
FTPでの設置時注意事項†
FTPそのものやFTPクライアントに関する情報は他にまかせるとして、下記を参考にFTPクライアントの設定を確認しておいてください。
- ファイル転送モード
- バイナリモード(binary mode)で転送するもの
- アスキーモード(ascii mode)で転送するもの
- 画像ファイル以外のファイル「*.php、*.txt、*.lng、*.css、*.js」
- 文字コードと改行コードの変換
使用するFTPクライアントによっては、ファイル転送時に文字コードや改行コードを変換しながら転送する機能が搭載されている場合があります。ローカル編集したファイルをコードの違うサーバーへ転送する時は重宝する機能ですが、今回のような初期の設置時には注意が必要です。
バイナリーファイルである画像「*.gif、*.png」以外の「*.php、*.txt」等のアスキーファイルは、「文字コード:EUC-JP、改行コード:LF」となっています。これらは、このまま設置した場合に動作するよう調整していますので、無変換転送を行なってください。
PukiWikiのファイル一覧†
PukiWikiで必要なディレクトリとファイルは次のとおりです。パーミッションと転送モードの別を色分けして表示しています。
ディレクトリ | 755 | |
ディレクトリ | 777 | |
ファイル | 644 | ASCII(EUC) |
ファイル | 644 | Binary |
ファイル | 666 | ASCII(EUC) |
ディレクトリ・ファイル | 不要 | |
- (755)./
- (644/ASCII).htaccess
- (644/ASCII)en.lng
- (644/ASCII)ja.lng
- (644/ASCII)default.ini.php
- (644/ASCII)index.php
- (644/ASCII)keitai.ini.php
- (644/ASCII)pukiwiki.php
- (644/ASCII)pukiwiki.ini.php
- (644/ASCII)rules.ini.php
- COPYING.txt
- README.txt
- README.en.txt
- UPDATING.txt
- UPDATING.en.txt
- (777)./attach
- (644/ASCII).htaccess
- (644/ASCII)index.html
- (777)./backup
- (644/ASCII).htaccess
- (644/ASCII)index.html
- (777)./cache
- (666)recent.dat
- (666)entities.dat
- (644/ASCII).htaccess
- (644/ASCII)index.html
- (777)./counter
- (644/ASCII).htaccess
- (644/ASCII)index.html
- (777)./diff
- (644/ASCII).htaccess
- (644/ASCII)index.html
- (755)./image
- (644/Bin)pukiwiki.gif
- (644/ASCII)index.html
- (644/Bin)add.png
- ahl-good.png
- b_pukiwiki.dev.png
- b_pukiwiki.org.png
- (644/Bin)backup.png
- (644/Bin)copy.png
- (644/Bin)diff.png
- (644/Bin)edit.png
- (644/Bin)file.png
- (644/Bin)freeze.png
- (644/Bin)help.png
- (644/Bin)list.png
- (644/Bin)new.png
- (644/Bin)pukiwiki.png
- (644/Bin)recentchanges.png
- (644/Bin)reload.png
- (644/Bin)rename.png
- (644/Bin)rss.png
- (644/Bin)search.png
- skin.png;
- (644/Bin)top.png
- (644/Bin)unfreeze.png
- valid-xhtml10.png
- valid-xhtml11.png
- vcss.png
- (755)./image/face
- (644/ASCII)index.html
- (644/Bin)bigsmile.png
- (644/Bin)heart.png
- (644/Bin)huh.png
- (644/Bin)oh.png
- (644/Bin)sad.png
- (644/Bin)smile.png
- (644/Bin)wink.png
- (644/Bin)worried.png
- (755)./lib
- (644/ASCII).htaccess
- (644/ASCII)index.html
- (644/ASCII)auth.php
- (644/ASCII)backup.php
- (644/ASCII)config.php
- (644/ASCII)convert_html.php
- (644/ASCII)diff.php
- (644/ASCII)file.php
- (644/ASCII)func.php
- (644/ASCII)html.php
- (644/ASCII)init.php
- (644/ASCII)link.php
- (644/ASCII)mail.php
- (644/ASCII)make_link.php
- (644/ASCII)mbstring.php
- (644/ASCII)plugin.php
- (644/ASCII)proxy.php
- (644/ASCII)pukiwiki.php
- (644/ASCII)trackback.php
- (755)./plugin
- (644/ASCII).htaccess
- (644/ASCII)index.html
- (644/ASCII)add.inc.php
- (644/ASCII)aname.inc.php
- (644/ASCII)article.inc.php
- (644/ASCII)attach.inc.php
- (644/ASCII)back.inc.php
- (644/ASCII)backup.inc.php
- (644/ASCII)br.inc.php
- (644/ASCII)bugtrack.inc.php
- (644/ASCII)bugtrack_list.inc.php
- (644/ASCII)calendar.inc.php
- (644/ASCII)calendar_edit.inc.php
- (644/ASCII)calendar_read.inc.php
- (644/ASCII)calendar_viewer.inc.php
- (644/ASCII)calendar2.inc.php
- (644/ASCII)clear.inc.php
- (644/ASCII)color.inc.php
- (644/ASCII)comment.inc.php
- (644/ASCII)counter.inc.php
- (644/ASCII)deleted.inc.php
- (644/ASCII)diff.inc.php
- (644/ASCII)edit.inc.php
- (644/ASCII)filelist.inc.php
- (644/ASCII)freeze.inc.php
- (644/ASCII)hr.inc.php
- (644/ASCII)img.inc.php
- (644/ASCII)include.inc.php
- (644/ASCII)includesubmenu.inc.php
- (644/ASCII)insert.inc.php
- (644/ASCII)interwiki.inc.php
- (644/ASCII)links.inc.php
- (644/ASCII)list.inc.php
- (644/ASCII)lookup.inc.php
- (644/ASCII)ls.inc.php
- (644/ASCII)ls2.inc.php
- (644/ASCII)map.inc.php
- (644/ASCII)md5.inc.php
- (644/ASCII)memo.inc.php
- (644/ASCII)menu.inc.php
- (644/ASCII)navi.inc.php
- (644/ASCII)new.inc.php
- (644/ASCII)newpage.inc.php
- (644/ASCII)norelated.inc.php
- (644/ASCII)online.inc.php
- (644/ASCII)paint.inc.php
- (644/ASCII)pcomment.inc.php
- (644/ASCII)popular.inc.php
- (644/ASCII)random.inc.php
- (644/ASCII)read.inc.php
- (644/ASCII)recent.inc.php
- (644/ASCII)ref.inc.php
- (644/ASCII)referer.inc.php
- (644/ASCII)rename.inc.php
- (644/ASCII)rss.inc.php
- (644/ASCII)rss10.inc.php
- (644/ASCII)ruby.inc.php
- (644/ASCII)search.inc.php
- (644/ASCII)server.inc.php
- (644/ASCII)setlinebreak.inc.php
- (644/ASCII)showrss.inc.php
- (644/ASCII)size.inc.php
- (644/ASCII)source.inc.php
- (644/ASCII)tb.inc.php
- (644/ASCII)template.inc.php
- (644/ASCII)topicpath.inc.php
- (644/ASCII)touchgraph.inc.php
- (644/ASCII)tracker.inc.php
- (644/ASCII)tracker_list.inc.php
- (644/ASCII)unfreeze.inc.php
- (644/ASCII)update_entities.inc.php
- (644/ASCII)version.inc.php
- (644/ASCII)versionlist.inc.php
- (644/ASCII)vote.inc.php
- (644/ASCII)yetlist.inc.php
- readme.ja.txt
- (755)./skin
- (644/ASCII)default.en.css
- (644/ASCII)default.ja.css
- (644/ASCII)print.en.css
- (644/ASCII)print.ja.css
- (644/ASCII)trackback.css
- (644/ASCII).htaccess
- (644/ASCII)index.html
- (644/ASCII)default.js
- (644/ASCII)trackback.js
- (644/ASCII)keitai.skin.ja.php
- (644/ASCII)pukiwiki.skin.en.php
- (644/ASCII)pukiwiki.skin.ja.php
- (777)./trackback
- (644/ASCII).htaccess
- (644/ASCII)index.html
- (777)./wiki
- (644/ASCII).htaccess
- (644/ASCII)index.html
- (666)…….txt
- (777)./wiki.en
- (644/ASCII).htaccess
- (644/ASCII)index.html
- (666)…….txt
動作確認†
pukiwiki.phpにブラウザからアクセスしてデフォルトページが表示できれば、基本的に設置は完了です。
念の為、以下の機能が正常に機能する事を確認しましょう。
- articleあるいはvoteプラグインで記事の投稿、投票ができること
- ページの新規作成ができること
- ページの削除ができること
- ページの凍結、凍結解除ができること(凍結中は編集できないこと)
PukiWikiのカスタマイズ†
めでたく設置に成功したら、PukiWikiを自分好みにカスタマイズしていきましょう。
pukiwiki.ini.php による設定†
"インストールする前に"で行なった設定以外に pukiwiki.ini.php の気になる項目があれば変更してみて下さい。
- よく変更される項目
- トップページの名前
注意 : 1.3系列とは異なり、トップページ名に日本語を使う場合でもBracketNameにしないでください。
$defaultpage = "フロントページ";
- サイトのタイトル
ブラウザのタイトルバーに表示される名前です。
$page_title = "フロントページ";
- 編集者の名前
ページのフッターに表示されます。
$modifier = 'Hogeta piyozou';
- 編集者の連絡先
ページのフッターの編集者名のリンク先になります。
$modifierlink = 'http://www.hoge.piyo/';
MenuBarの活用†
初期状態では、「最近のxx件」という表示と共に日付とWikiNameがずらっと左側に並んでいるはずです。ページが新規作成/更新されれば、新たにWikiNameが増えたり、すでに表示されてあったWikiNameの上下位置が入れ替わったりと自動で変化しますので、表示されているWikiNameをクリックしさえすれば、自由に閲覧することが可能です。
もちろん、この初期状態のままでも使用に問題はありませんが、せっかくですからメニューの作成などをしてみてはいががでしょうか?
とにもかくにも編集するためにMenuBarへと辿り着かなければ始まりません。「最近のxx件」という表示の中にMenuBarというWikiNameがあればそこから辿れます。無ければ、上部メニューの「単語検索」をクリックして
MenuBar
と打ち込み検索すれば、見付かるはずです。
ここまで辿り着いたら後は簡単。通常の編集となにも変わりませんので、自分好みにカスタマイズして下さい。
その他、ちょっと便利にのページでは改造/活用のヒントが紹介されています。
スキンとCSSによる外観の変更†
- よく変更される項目
- トップページのリンク
pukiwiki.skin.en.php/pukiwiki.skin.ja.php の23行目あたりに、ページ左上のアイコンのリンク先があります。トップページを表示するのが一般的なようです。
<a href="http:// pukiwiki.org/">
↓
<a href="http://www.hoge.piyo/pukiwiki.php">
- ページ左上のアイコンは
ページ左上のアイコンは pukiwiki.png を置き換えればOKです。参考までに標準添付のアイコンのサイズは80x80 Pixelです。
プラグインやカスタマイズによる機能追加†
設置が正常に完了して、サイトの外観も決まったら、実際に色々なページを作ってみます。
しばらく使っていくうちに欲しい機能や実現したい動作ができた場合はFAQ、質問箱、自作プラグインに目を通してみてください。
ページの構成などで迷った場合は、他のPukiWikiサイトをリンク集や検索エンジンで見てみる(google:PukiWiki)と参考になるかもしれません。
順調に稼動できたら†
設置が完了して、順調に運用できた場合はPukiWiki使用者への100?の質問に答えてみて下さいませ。
PukiWiki 1.3系から1.4への移行†
- 【注意】
PukiWiki 1.3系から1.4へ移行する前に、ほんとうにご自分のサイトで1.4の機能が必要かどうか検討した上で移行しましょう。1.3系の機能で十分であるならば、あえて1.4に移行する必要はありません。
PukiWiki 1.3系は1.4が正式リリースされた後も、セキュリティ関係のバグフィックスなどのサポートは継続して行ないます(新機能の追加は行ないません)。
バックアップ†
バックアップは非常に大切です。以下の作業を行う前に、*.phpやスキン、プラグイン、attach,backup,counter,diff,wikiディレクトリを含む全てのデータをバックアップしてください。(やり方はお任せします :) )
1.4のインストール†
- 【補足】
- 1.4ではDOCTYPEがXHTML 1.1に移行しています。自作のスキンやプラグインを引き続き使用する場合は、XHTML 1.1の書式に書き換える必要があります。
また、プラグインについては1.3系列のプラグインをそのまま使用できるとはかぎりません(プラグイン/開発者向け参照)。標準のプラグインは1.4に添付されたものをインストールしてください。
- 【注意】
- 1.4ではcacheディレクトリ、trackbackディレクトリが追加されています。ここのパーミッションの設定(ディレクトリは777、*.datは666)を忘れると下記のページ変換時にエラーが出ます。
ファイル名からBracket部分を取り去る†
- stripbracket.inc.phpをpluginディレクトリにインストール 配布場所
- http://.../pukiwiki.php?plugin=stripbracketを実行
- pluginディレクトリのstripbracket.inc.phpを削除
リンクキャッシュを初期化する†
- http://.../pukiwiki.php?plugin=linksを実行
書式の違いをコンバート†
書式の移行を手動で行う場合は、このステップを省略できます。
- convertpage.inc.phpをpluginディレクトリにコピー 配布場所
- http://.../pukiwiki.php?plugin=convertpageを実行
- pluginディレクトリのconvertpage.inc.phpを削除
- 【補足】
- 従来ユーザー定義だったcolor,sizeなどをインライン型プラグインに変換はしません。但し、ユーザー定義のcolorやsizeを&~;の形式で定義していた場合は、そのままインラインプラグインで解釈されるようになりますので書き換えは不要です*2。
ユーザー定義のcolorやsizeを&~;の形式とは異なる形で定義していた場合は、従来のユーザー定義をそのまま残しておけば書き換えは不要です*3。
aname、counter、online、versionはインライン型プラグインに移行しています。convertpage.inc.phpではこれらをコンバートしませんので、aname以外は書き換えが必要です。
PukiWiki 1.4.3以前から1.4.4以降への移行†
PukiWiki1.4.4で何が起こったか†
PukiWiki 1.4.3→1.4.4の改訂の過程で機能追加・ロジックの整理・バグ取りもさることながら、大掛かりなファイル配置の整理が行われています。
ここではPukiWiki1.4.3以前の版をお使いの方への変更概要+移行方法を紹介します。
なお、1.3.x系をお使いの方は../1.3系からの移行も併せてお読みください。
まずはバックアップ†
例によってバックアップは非常に大切です。以下の作業を行う前に、*.phpやスキン、プラグイン、attach,backup,counter,diff,wikiディレクトリを含む全てのデータをバックアップしてください。(やり方はお任せします :) )
ファイルの配置整理†
配置が変更された理由について†
- 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
各ファイルの移動元・移動先一覧†
1.4.3以前→1.4.4 のファイルの移動元・移動先をまとめた一覧です。
一旦は読み飛ばして、移行作業時に参照して下さい。。
移動元dir | ファイル名 | 移動先dir |
(なし) | index.html | 追加 -> ./lib*4 |
.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 | 追加*5 -> ./ |
(なし) | index.php | 追加*6 -> ./ |
./face | * | 移動 -> ./image/face へ |
(なし) | worried.png | 追加 -> ./image/face |
./plugin | dir.txt | 削除 |
(なし) | index.html | 追加 -> ./plugin |
.htaccess |
clear.inc.php | 追加 -> ./plugin*7 |
setlinebreak.inc.php |
topicpath.inc.php |
./attach | * | 基本変更なし*8 |
./backup |
./cache |
./counter |
./diff |
./image |
./skin |
./trackback |
./wiki |
./wiki.en |
./devel | 削除*9 |
./ | *.txt | 変更なし*10 |
移行の手順†
CVSを使う方法†
LIB_DIR (./lib/) に移動したファイルに関して: お手元でこれらのファイルをカスタマイズされており、CVSを用いてマイグレートされる方のために、移動前の最後のバージョンに、タグ pkwk14_2004-08-01_moved-before を打ってあります。このタグを(移動前の最新の状態に)マージするためのターゲットにお使い下さい。
CVSを使わない方法†
方法はいろいろありますが、あくまで一例として。
ファイルの移動以外にも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の一番下のタグを切り替えてた後に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、初期状態で用意されているページ、使わないプラグインなど必要に応じて、適宜削除する。