* PukiWiki 1.5のインストール(PukiWiki-1.5.0以降) [#kf1bfe0c]
:※&color(red){重要};|更新作業中のため、一部の記述が最新バージョンに対応していない可能性があります
:※&color(red){重要};|
PukiWiki 本体は、スクリプトで書かれたwiki 機能のみのソフトです。~
簡易のセキュリティとして管理者パスワードやユーザ認証などの機能やそれらを扱うラッパーは存在していますが、これだけでハッキングやSPAM などの脅威を防ぐ事はできません。~
このためネットワーク上で運用する際には、サーバーを設定・運用するスキルや本体への改修や機能追加(改造と称される場合もあります)を行うスキルなどが必須となります。

#contents

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

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

特定環境での事例や注意点については、[[特定の環境・サーバーへのインストール(設置)>PukiWiki/Install#eb463129]]や[[Q&A/動作環境]]、[[動作実績]]などもご覧ください。

//- &color(red){注意};: PHP 5.1以降で動作させる場合は、PHP5関連BugTrackのまとめの各項目を必ず確認してください。互換性などの確認のため、パッケージ未収録の修正があります
//-- PHP5関連BugTrackのまとめ -- [[dev:BugTrack/632]] (PHP5.3: [[dev:BugTrack2/324]]、PHP5.4: [[dev:BugTrack2/349]])
- &color(red){注意};: リリース時期や互換性確認などの関係で、一部修正がパッケージ未収録の場合もあります。上記のページに情報が無い場合は、[[BugTrack]]や[[質問箱>質問箱5]]で報告されていないかを確認してください。


** 前提 [#we4ef591]
設置方法には複数の選択肢があります。

配布ファイルである tar.gz あるいは zip ファイルをそのまま設置サーバーへ放り込み、サーバー側で解凍、設定を行なうことも出来ますし、ローカルで解凍、設定したのち、FTPでファイル転送を行うことも可能です。~
しかし公開サイトに設置する場合は、セキュリティソフトや機能などを併用せずに未設定のままで解凍するとwikiが攻撃される危険性が高まります。

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

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

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

また、文字コードや改行コードはUTF-8 版デフォルトの「文字コード:UTF-8、改行コード:LF」としています(EUC-JP 版は、「文字コード:EUC-JP、改行コード:LF」)。~
各ファイルを修正する前に、利用しているエディタがこれらの文字コードを扱えるのか(例えば、Win のメモ帳は、EUC-JP を扱えずLF のみは改行として認識しません)を、よく確認してください。([[対応しているエディタの一例>Q&A/インストール#mb87f9af]])~
また対応しているエディタであっても、ファイルの読み込み時や保存時に文字コードや改行コードが変わってしまわないように、エディタの設定を確認してください。


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

既存のあるいはローカルで準備したコンテンツを他のサーバーに移動させる場合などは、[[PukiWiki/Install/アップグレード時の注意]] も確認してください。~
このページでは省略している、PukiWiki 稼動後に生成されるデータ(バックアップや添付ファイルなど)に関する説明があります。

上位バージョンにアップグレードする場合は、[[PukiWiki/Install/アップグレード時の注意]] や、パッケージ付属のUPDATING.txt 、このページの後半部分にある「~への移行」の該当部分も忘れずに確認してください。設定やデータの移行方法、変更になった仕様や設定方法に関する説明があります。

動作ベースとなる文字コードの変更(無印やEUC-JP 版からUTF-8 版に移行など)をしたい場合は、各コンテンツファイルの文字エンコード変更とファイル名変換を行う必要があります。詳しくは、[[dev:BugTrack2/186]] - UTF-8版関係のまとめをご確認ください。

*** pukiwiki.ini.php の修正 [#aa4d05e6]
:管理者の名前|
 $modifier = 'anonymous';
上記のanonymousの部分をあなたの名前に書き換えましょう。日本語でもかまいません。

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

:管理者パスワード|
-- 設定方法~
 $adminpass = '{x-php-md5}!';
上記の「{x-php-md5}&color(red){''!''};」の部分を書き換えます。~
''{x-php-md5}'' と頭に記述した場合は、MD5による暗号化したパスワードを書き込む必要がありますが、とりあえずは
    $adminpass = '{x-php-md5}' . md5('your-pasword');
といった形式でyour-paswordの部分をあなたが決めた別のパスワードに書き換えて記述しておきましょう。~
正式にPukiWikiを使い続けることを決めてから、MD5によって暗号化した文字列に書き換えればいいです。~
~MD5 以外の暗号化フォーマットを利用することもできます。詳しくは[[dev:BugTrack/709]] をご覧ください。
-- 暗号化したパスワードを得る方法~
MD5ハッシュは、Linuxやcygwinであれば以下のようにして計算させる事ができます。('-n' オプションを忘れずに!)
     $ echo -n 'pass' | md5sum
当然、passは別のパスワードに書き換えて暗号化した文字列を生成し、それを設定してください。~
FreeBSDなどでは md5sum の代わりに md5 コマンドを使ってください。
~他に、[[md5 プラグイン>PukiWiki/1.4/Manual/Plugin/L-N#wec9aa1f]]を使うことでも生成は可能ですが、~
ネットワーク上に通信内容が丸見えになってしまう(= パスワードがばれてしまう)ので、利用する際はローカル環境を使うなど細心の注意が必要です。


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

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

なお、配布時は index.php にアクセスするとデータが表示される様になっていますが、名前を既存ファイルと衝突しない別のもの(たとえば wiki.phpなど)に変更してもかまいません。

** FTPで設置する時の注意事項 [#bc9b5551]
FTPそのものやFTPクライアントに関する情報は他にまかせるとして、下記を参考にFTPクライアントの設定を確認しておいてください。

*** ファイル転送モード [#h81713b7]
- バイナリモード(binary mode)で転送するもの:
-- 画像ファイル「*.gif、*.png」
- アスキーモード(ascii mode)で転送するもの:
-- 画像ファイル以外のファイル一例「*.php、*.txt、*.lng、*.css、*.js」


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

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

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

:&color(red){注意};|
~入り口であるindex.php などのWebブラウザからアクセスする必要のあるファイルを除き、ほぼ全てのファイルを外部に対して非公開設定にする必要があります。~
PukiWikiのパスワードが書かれた設定ファイルなどを外部から簡単に覗き見られないよう、アクセスできない事を必ず確認して下さい。
:&color(red){注意};|
~以下に示しているパーミッションは、設定の一例です。CGI版PHP を利用しているなどの理由で、このパーミッション設定では動作しない(エラーが出る)場合があります。~
この場合、サーバーの利用マニュアルや[[PukiWiki/CGI版PHPで動作させるには]]を参考に、設定値を読み替えて下さい。また、[[オーナー(所有者)の設定>PukiWiki/Install/パーミッション設定#of0afc6f]]を適切なものに変更して下さい。


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

-- &color(red){(755)./};
-- &color(blue){(644/ASCII).htaccess};
-- &color(blue){(644/ASCII)en.lng.php};
-- &color(blue){(644/ASCII)ja.lng.php};
-- &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%%}; 1.4.7 以降は削除されています。必要な方はindex.php の内容をコピーして作成してください。
-- &color(blue){(644/ASCII)pukiwiki.ini.php};
-- &color(blue){(644/ASCII)rules.ini.php};
-- COPYING.txt
-- README.txt
-- README.en.txt.zip
-- README.en.txt (Archived README.en.txt.tgz or README.en.txt.zip)
-- UPDATING.txt
-- UPDATING.en.txt.zip
-- UPDATING.en.txt (Archived UPDATING.en.txt.tgz or UPDATING.en.txt.zip)

-- &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(blue){(644/ASCII)index.html};
--- &color(forestgreen){(644/Bin)add.png};
--- ahl-good.png
--- atom.png
--- b_pukiwiki.dev.png
--- b_pukiwiki.official.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};
--- hinad.png
--- lirs.png
--- &color(forestgreen){(644/Bin)list.png};
--- &color(forestgreen){(644/Bin)new.png};
--- &color(forestgreen){(644/Bin)noimage.png};
--- opml.png
--- paraedit.png
--- &color(forestgreen){(644/Bin)pukiwiki.gif};
--- &color(forestgreen){(644/Bin)pukiwiki.png};
--- &color(forestgreen){(644/Bin)rdf.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)rss20.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
--- xml.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}; 削除されました(詳細: [[dev:BugTrack2/62]])

-- &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)amazon.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)author.inc.php}; (1.5.1 で追加)
--- &color(blue){(644/ASCII)back.inc.php};
--- &color(blue){(644/ASCII)backup.inc.php};
--- &color(blue){(644/ASCII)basicauthlogout.inc.php}; (1.5.1 で追加)
--- &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)contents.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)dump.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)loginform.inc.php}; (1.5.1 で追加)
--- &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)nofollow.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}; TrackBack機能に依存していたため削除されました(詳細: [[dev:BugTrack2/62]])
--- &color(blue){(644/ASCII)related.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};
--- stationary.inc.php [[プラグイン作成>自作プラグイン]]の雛形サンプル、使用する場合は他と同じく&color(blue){(644/ASCII)};で
//--- &color(blue){(644/ASCII)tb.inc.php}; 削除されました(詳細: [[dev:BugTrack2/62]])
--- &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).htaccess};
--- &color(blue){(644/ASCII)index.html};
//--- %%default.js%% 未使用ファイルのため削除されました(詳細: [[質問箱/28]], [[dev:BugTrack/475]])
//--- %%trackback.css%% &color(red){削除対象};のため削除されました(詳細: [[dev:BugTrack2/62]])
//--- %%trackback.js%% &color(red){削除対象};のため削除されました(詳細: [[dev:BugTrack2/62]])
--- &color(blue){(644/ASCII)keitai.skin.php};
--- &color(blue){(644/ASCII)pukiwiki.css.php};
--- &color(blue){(644/ASCII)pukiwiki.skin.php};
--- &color(blue){(644/ASCII)tdiary.css.php}; (詳細: [[tDiary]])
--- &color(blue){(644/ASCII)tdiary.skin.php}; (詳細: [[tDiary]])

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

-- &color(maroon){(777)''./wiki.en''}; (wiki.en.zipに格納されています)
-- &color(maroon){(777)''./wiki.en''};  (Archived wiki.en.tgz or wiki.en.zip)
--- &color(blue){(644/ASCII).htaccess};
--- &color(blue){(644/ASCII)index.html};
--- &color(fuchsia){(666)…….txt};


** 動作確認 [#c68fc6b0]
index.php にブラウザからアクセスしてデフォルトページが表示でき、なおかつpukiwiki.ini.php などの重要ファイルをブラウザから覗き見できなければ、基本的に設置は完了です。

念の為、以下の機能が正常に機能する事を確認しましょう。
- ページの編集ができること (FrontPageなど、凍結されていないページについて)
-- ※編集時に Runtime Errorが出る場合、更新されるファイルのパーミッションや、それらを収めているディレクトリのパーミッションとオーナーを確認して下さい
- ページの新規作成、および削除ができること
-- ※Runtime Errorが出る場合、wiki/ ディレクトリなどのパーミッションを確認して下さい
試したことがなければ、以下の操作もやってみましょう。
- ページの凍結、および凍結解除ができること(設定した管理者パスワードが必要です)
-- 凍結したファイルが編集できないこと
- articleあるいはvoteプラグインで記事の投稿、投票ができること

もし、正常に表示されなかったり、エラーが出るようなら、[[Q&A/インストール]]などを参考にしてください。

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

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

:トップページとして表示するページの名前|
注意 : 1.3系列とは異なり、トップページ名に日本語を使う場合でもBracketNameにしないでください。
    $defaultpage = "フロントページ";
:サイトのタイトル|
ブラウザのタイトルバーに表示される名前です。
    $page_title = "サイト名";
:ユーザ認証|
詳しくは、[[PukiWiki/Authentication]]を参照してください。

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

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

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

:|
    MenuBar

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

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

その他、[[Q&A/デザイン・CSS>Q&A/デザイン・CSS#ub313802]], [[ちょっと便利に]]のページでは改造/活用のヒントが紹介されています。

*** スキンやCSSの改造による外観の変更 [#ke9d161f]
ページ左上のアイコンは image/pukiwiki.png を置き換えればOKです。

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

関連: [[カスタマイズ]]、 [[スキン]]、 [[Q&A/デザイン・CSS]]

*** プラグインやカスタマイズによる機能追加 [#r40f3b48]
設置が正常に完了して、サイトの外観も決まったら、実際に色々なページを作ってみます。

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

プラグインの中には''プラグイン内設定''を変更することでデフォルトの動作を変更する事ができるものがあります。~
PukiWiki に同梱されているものに関しては、ヘルプから[[プラグインマニュアル>PukiWiki/1.4/Manual/Plugin]]を呼び出し確認してみてください。~
(アップグレード時にwikiデータを上書きしなかった場合、過去バージョンの内容のままになっていますので、注意してください)

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

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

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




-----------------------------------------
* PukiWiki 1.5.0から1.5.xへの移行 [#f365298f]
** to 1.5.1 [#c3667374]
(コンテンツ準備中)~
- 部分アップデートしていたなどで[[開発版>dev:開発版]](Gitリポジトリ)を使用してパッチを作成する場合、リポジトリ内部の変更(EUC-JP 版 → UTF-8 版)に対応する必要があります。
// タグはこれで合ってる?
//設定やエンコードの変更が行われる前後のタグ ''r1_5_end-eucjp''と''r1_5_start-utf8''


-----------------------------------------
* PukiWiki 1.4.7から1.5.0への移行 [#z3edbed5]
~[[PukiWiki/Install/Update/1.5.0]]を参考にアップグレードしてください。


-----------------------------------------
* PukiWiki 1.4-1.4.6から1.5.0への移行 [#t22d4190]
~ここではPukiWiki 1.4-1.4.6の版をお使いの方への変更概要+移行方法を紹介します。
個々の変更点の詳細については、[[PukiWiki/Download]]の各ページをご覧下さい。
~なお、1.3.x系をお使いの方は[[1.3系からの移行>#v1fa0838]]も併せてお読みください。

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

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

*** ファイルの配置が変更された理由について [#mb2c4ca9]
+ 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]]

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

:入り口をpukiwiki.php のまま維持したい方へ|
下記の移動および追加などを完了させた上で、1.4.4で追加した./index.php をリネームして下さい。

|移動元dir|ファイル名|移動先dir|h
|(なし)|index.html|1.4.4で追加 -> ./lib((1.4.4で新規に追加されたフォルダです。パーミッションはpluginディレクトリと同じにしてください))|
|~|.htaccess |~|
|./    |auth.php  |1.4.4で移動 -> ./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|1.4.4で移動、のちに削除 (利用禁止の詳細: [[dev:BugTrack2/62]])|
|~|pukiwiki.gif|1.4.4で移動 -> ./image|
|~|pukiwiki.png|~|
|~|i_mode.ini.php|1.4.4で削除 -> keitai.ini.phpに統合|
|~|jphone.ini.php|~|
|~|*.lng|1.4.5で変更 -> *.lng.php|
|~|*.ini.php|変更なし|
|(なし)|keitai.ini.php|1.4.4で追加 -> ./|
|~|index.php|1.4.4で追加 -> ./ ((来訪者の入り口となるプログラム))|
//|~|pukiwiki.php|1.4.4で追加、1.4.7で削除|
|./image|b_pukiwiki.dev.png|1.4.6でデータ差し替え|
|~|b_pukiwiki.org.png|1.4.6で削除|
|(なし)|index.html|1.4.4で追加 -> ./image|
|~|b_pukiwiki.official.png|1.4.6で追加 -> ./image|
|./face|*|1.4.4で移動 -> ./image/face へ|
|(なし)|worried.png|1.4.4で追加 -> ./image/face|
|./plugin|dir.txt|削除|
|~|referer.inc.php|[[TrackBack]]機能に依存していたため削除されました|
|~|tb.inc.php|削除されました (利用禁止の詳細: [[dev:BugTrack2/62]])|
|(なし)|index.html|1.4.4で追加 -> ./plugin|
|~|.htaccess|~|
|~|clear.inc.php|1.4.3で追加 -> ./plugin|
|~|setlinebreak.inc.php|~|
|~|topicpath.inc.php|~|
|~|dump.inc.php|1.4.5で追加 -> ./plugin|
|~|lastmod.inc.php|~|
|~|related.inc.php|~|
|~|stationary.inc.php|1.4.5_1で追加 -> ./plugin ((自作用の雛形サンプルのため通常は不要))|
|~|br.inc.php|1.4.6で追加 -> ./plugin|
|~|nofollow.inc.php|~|
|./skin|trackback.css|削除 (利用禁止の詳細: [[dev:BugTrack2/62]])|
|~|trackback.js|~|
|~|default.en.css|1.4.5で削除 -> pukiwiki.css.phpに統合|
|~|default.ja.css|~|
|~|print.en.css|~|
|~|print.ja.css|~|
|~|pukiwiki.skin.en.php|1.4.5で削除 -> pukiwiki.skin.phpに統合|
|~|pukiwiki.skin.ja.php|~|
|(なし)|index.html|1.4.4で追加 -> ./skin|
|~|.htaccess|~|
|~|pukiwiki.css.php|1.4.5で追加 -> ./skin|
|~|pukiwiki.skin.php|~|
|~|tdiary.css.php|1.4.5で追加 -> ./skin (([[tDiary]]スキンが必要な場合のみ該当))|
|~|tdiary.skin.php|~|
|./attach|*|基本変更なし((pukiwikiの動作に直接関係はしませんが、1.4.4でdir.txtが削除されてindex.html, .htaccessが追加されています))|
|./backup |~|~|
|./cache  |~|~|
|./counter|~|~|
|./diff   |~|~|
|./trackback|~|~|
|./wiki   |~|~|
|./wiki.en|~|~|
|./devel  |~|削除((pukiwikiの動作には必要ないので、実運用環境には作成していないと思いますが、一応))|
|./       |*.txt|変更なし((pukiwikiの動作には必要ないので、実運用環境には作成していないと思いますが、一応))|

** PukiWiki 1.4.4-1.4.5から1.4.6で何が起こったか [#ye993990]
管理者のパスワードとユーザー認証のパスワードを保管する際の暗号化形式を容易に変更できるようにするため、書式が変更されました

*** 管理者パスワードとユーザ認証パスワード [#w93a841d]
1.4.6 以降では管理者パスワードとユーザーパスワードの保存形式が「RFC2307および既存のLDAP実装」に準拠となり、「{x-php-md5}」のようなプリフィクス付きの形式に変更となりました。~
従来のMD5形式で管理者パスワードを使う場合は、先頭に
 {x-php-md5}
を追加する必要があります。(そのままでは、暗号化後の文字列がパスワードだと認識されてしまいます)

MD5 以外の暗号化フォーマットに切り替える事も可能です。指定できるプリフィクスなど、詳しくは[[dev:BugTrack/709]] をご覧ください。


** 移行の手順 [#rb17556f]

*** Gitクライアントを使う方法 [#zbaaea84]
(コンテンツ準備中)~
LIB_DIR (./lib/) に移動したファイルに関して: お手元でこれらのファイルをカスタマイズされており、Gitを用いてマイグレートされる方のために、移動前の最後のバージョンに、タグ ''pkwk14_2004-08-01_moved-before'' を打ってあります。このタグを(移動前の最新の状態に)マージするためのターゲットにお使い下さい。

*** CVSクライアントを使う方法 [#n667d5cc]
CVSのみで1.5.0以降へアップグレードする事はできません。(1.5.0はGitだけに格納されています)~
タグ ''r1_4_7_notb'' で[[1.4.7_notb>PukiWiki/Download/1.4.7]]までアップグレードした後、[[1.4.7(notb)から1.5.0へのアップグレードパッチ>PukiWiki/Download/1.5.0#za58ab70]]を適用して下さい。

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

*** GitまたはCVSのクライアントを使わない方法 [#xbe36973]
方法はいろいろありますが、あくまで一例として。

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

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

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

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

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

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

+ [[開発版>dev:開発版]](GitまたはCVSのリポジトリ)から最後に自分が持ってきた版に一番近い版を持ってきましょう。(リポジトリからパッケージをまるごとダウンロードする場合は、その場でアーカイブを作成するために時間がかかります)
-- GitリポジトリをクライアントではなくWebブラウザで閲覧する場合は、まず上のメニューから「タグ」を選択します。次に目的のタグ横のRev. からタグの詳細情報に移動し、「tree」からタグに所属するファイル構成ツリーを表示します。最後に、エクスポート横の「ZIP」「TAR」からファイル形式を選択し、所属する全ファイルのダウンロードを開始します。
-- CVSリポジトリをクライアントではなくWebブラウザで閲覧する場合は、一番上で「r1_4_3」のような各リリースバージョンのタグを切り替えた後に一番下にあるDownloadを選びます。
+ 自分のPukiWikiと1の手順で持ってきた版とのdiffを取り、自分が変更した箇所を特定して、控えておきます。
//+ PukiWiki 1.5のファイルを適当な別ディレクトリに展開して、自分のPukiWikiからattach、backup、cache、counter、diff、trackback、wiki を全てコピーする。
+ PukiWiki 1.5のファイルを適当な別ディレクトリに展開して、自分のPukiWikiからattach、backup、cache、counter、diff、wiki を全てコピーする。
-- EUC-JP 版(旧無印版)からUTF-8 版に移行したい場合は、ファイルの文字エンコード変更とコンテンツファイルのファイル名変換を別の場所で行った上で1.5に動かす必要があります。詳しくは、[[dev:BugTrack2/186]] - UTF-8版関係のまとめ をご確認ください。
+ PukiWiki 1.5のファイルに対して、2の手順で検出した変更を書き戻して反映していきます。もし1.5用のパッチがあるのなら、過去のパッチを使わずに最新パッチを使う方が無難でしょう。
++ 書き換えるファイルは主に*.ini.php、lib/ や plugin/ が中心だと思いますが skin/ などもお忘れなく。
+ 独自プラグインや自分で作ったフェイスマークなど、配布ファイルに含まれていないものを追加する。
+ 配布ファイルに含まれているファイルで不要なものを削除する。
++ *.txtや、imageの中の画像、devel、初期状態で用意されているページ、使わないプラグインなど必要に応じて、適宜削除する。

*** [[自作プラグイン]]や[[自作スキン]]などをPHP5.4 以降対応に改修する [#z10249b4]
([[dev:BugTrack2/355]])

[[PHP関数:htmlspecialchars]]を使用している箇所を新設のhtmlsc関数に変更したり、左記を含むマルチバイト文字列を受け付ける関数で入出力の文字コードを明示指定して文字化けなどを防いだり、といった修正が必要ではないかを確認しないと、これまでどおり動作しなくなるかもしれません。~
まずは対応版がリリースされていないかを確認しましょう。


-----------------------------------------
* PukiWiki 1.3系から1.5.0への移行 [#v1fa0838]

:&color(crimson){【注意】};|
&color(crimson){1.3系の開発は終了};しました([[PukiWiki News>FrontPage#j9ea7df5]])~
サポートが終了したバージョンの[[PHP]]で稼動させ続ける事は危険ですので、自身で1.3系を改修し続けるか移行するかを選択してください。~

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

** 1.5のインストール [#kd6d4c6b]
- wikiディレクトリ以外のファイルをアップロード

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

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

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

** UTF-8 版に移行したい場合は、ファイル名と文字コードを変換 [#x36223ec]
EUC-JP 版(旧無印版)からUTF-8 版に移行したい場合は、ファイルの文字エンコード変更だけではなくコンテンツファイルのファイル名変換も必要です。詳しくは、[[dev:BugTrack2/186]] - UTF-8版関係のまとめをご確認ください。

** 書式の違いをコンバート [#c52ac72a]
書式の移行を手動で行う場合は、このステップを省略できます。
- convertpage.inc.phpをpluginディレクトリにコピー [[配布場所>dev:PukiWiki/1.4/1.3系からの移行]]
- http://.../pukiwiki.php?plugin=convertpageを実行
- pluginディレクトリのconvertpage.inc.phpを削除

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

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

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

トップ   編集 差分 バックアップ 添付 複製 名前変更 リロード   新規 一覧 検索 最終更新   ヘルプ   最終更新のRSS
Site admin: PukiWiki Development Team

PukiWiki 1.5.3+ © 2001-2020 PukiWiki Development Team. Powered by PHP 5.6.40-0+deb8u10. HTML convert time: 0.065 sec.

OSDN