INSTALL.txt

   1 名前
   2     PukiWiki  - 自由にページを追加・削除・編集できるWebページ構築スクリプト
   3
   4     Version 1.5.0
   5     Copyright (C)
   6       2001-2016 PukiWiki Development Team
   7       2001-2002 yu-ji (Based on PukiWiki 1.3 by yu-ji)
   8     License: GPL version 2 or (at your option) any later version
   9
  10     $Id: INSTALL.txt,v 1.9 2007/02/11 05:53:30 henoheno Exp $
  11
  12 インストール
  13     PukiWikiはPHPスクリプトであるため、(例えばPerlのように)スクリプトに実行権
  14     を付ける必要はありません。CGI起動でないのであれば、スクリプトの一行目を修
  15     正する必要もありません。
  16
  17     Webサーバーへのシェルアクセスが可能であれば、PukiWikiのアーカイブをそのま
  18     まサーバーに転送し、サーバー上で解凍(tar pzxf pukiwiki*.tar.gz) するだけ
  19     でパーミッションの設定も行われ、すぐに使い始める事ができるでしょう。
  20
  21     スクリプトの中の日本語は(あれば、基本的に)EUC-JPで、また改行コードはLFで
  22     記述されています。スクリプトを直接編集する場合は、日本語文字コードと改行
  23     コードの自動判別ができ、それを元のまま保存できるテキストエディタを使用し
  24     て下さい。
  25
  26     以下に、事前にクライアントPCで作業を行う場合の例を記します。
  27
  28     1. PukiWikiのアーカイブを展開します。
  29
  30     2. 設定ファイル(*.ini.php)の内容を確認します。何も修正せずとも動作します
  31        が、公開された場所に設置するのであれば、念のため事前に管理者パスワード
  32        を修正して下さい。
  33
  34        設定ファイルのほとんどの項目は pukiwiki.ini.php に集約されています。
  35
  36         全体設定           : pukiwiki.ini.php
  37         ユーザ定義         : rules.ini.php
  38
  39        その他、ユーザーエージェントごとの設定が用意されています。
  40
  41         デスクトップPC     : default.ini.php
  42         携帯電話およびPDA  : keitai.ini.php
  43            (旧 i_mode.ini.php/jphone.ini.php)
  44
  45       PukiWikiの管理者パスワードは、pukiwiki.ini.php にある変数 $adminpass
  46       です。簡単に試すだけであるならば、以下のような内容で充分でしょう。
  47       ('YourPassWord' の部分を、あなただけのキーワードで置き換えて下さい)
  48
  49          $adminpass = '{x-php-md5}' . md5('YourPassWord');
  50
  51       ※設定を「有効にする」とは、多くの場合、設定値を数字の 0 でない値(例え
  52         ば1)にする事です。一部の設定は名前に DISABLE ないし $noXXX とあります
  53         が、それらは値を 0 でないものにすることで、その設定値に対応する機能が
  54         無効になります。(無効にする役割が有効になります)
  55
  56       ※インターネットに公開するPukiWikiであるならば、PKWK_SAFE_MODE を有効に
  57         することをお薦めします。(詳細:BugTrack/787)
  58
  59       ※他人に編集させない環境をご要望であれば、PKWK_READONLY を有効にするこ
  60         とをお薦めします。(詳細:BugTrack/744)
  61
  62     3.  ファイルをFTPなどでサーバに転送します。
  63       基本的に何の変換も行わず、「そのまま」転送して下さい
  64       ・ファイル名や、ファイル名の大文字小文字などを変更しないで下さい
  65       ・FTPの転送モードは「バイナリ(bin)」を使用して下さい
  66
  67     4.  サーバ上のファイルおよびディレクトリのパーミッションを確認します。
  68
  69     ディレクトリ パーミッション
  70       attach         777        添付ファイル格納ディレクトリ
  71       backup         777        バックアップファイル格納ディレクトリ
  72       cache          777        キャッシュファイル格納ディレクトリ
  73       counter        777        カウンタファイル格納ディレクトリ
  74       diff           777        差分ファイル格納ディレクトリ
  75       image          755        画像ファイル
  76       image/face     755        (画像ファイル)フェイスマーク
  77       lib            755        ライブラリ
  78       plugin         755        プラグイン
  79       skin           755        スキン、CSS、JavaScirptファイル
  80       wiki           777        データの格納ディレクトリ
  81
  82     ファイル    パーミッション データの種類(参考)
  83       .htaccess      644       ASCII
  84       .htpasswd      644       ASCII
  85       */.htaccess    644       ASCII
  86
  87     ファイル    パーミッション データの種類(参考)
  88       *.php          644       ASCII
  89       */*.php        644       ASCII
  90       attach/*       666       BINARY (はじめは存在せず)
  91       backup/*.gz    666       BINARY (インストール時は存在せず)
  92       backup/*.txt   666       ASCII  (多くの環境では存在せず)
  93       cache/*        666       ASCII
  94         (一部のプラグインはバイナリファイルを保存します)
  95       counter/*      666       ASCII  (はじめは存在せず)
  96       diff/*.txt     666       ASCII  (はじめは存在せず)
  97       wiki/*.txt     666       ASCII
  98       image/*        644       BINARY
  99       image/face/*   644       BINARY
 100       lib/*          644       ASCII
 101       plugin/*       644       ASCII
 102       skin/*         644       ASCII
 103
 104     5. サーバーに設置した PukiWiki の index.php あるいは pukiwiki.php に、Web
 105       ブラウザからアクセスし、PukiWikiが動作するか様子を見ます。
 106
 107       ※エラーが出る場合: 下記を参照して下さい
 108
 109     6.  必要に応じて、さらに設定やデザインを調整して下さい。
 110
 111       ※CSS(外見)は skin/スキン名.css.php にあります。これは目的に応じたCSSを
 112         出力することのできる、単独のPHPスクリプトです。これを静的なファイルに
 113         したい場合は、Webブラウザで出力結果を取り出して下さい。どのようなCSS
 114         が求められているかはスキンに記述されています。
 115       ※スキン(外見の骨組み)に関する設定項目は skin/スキン名.skin.php の先頭に
 116         あります。
 117       ※プラグイン独自の設定項目は plugin/プラグイン名.inc.php の先頭にありま
 118         す
 119       ※tDiaryテーマ(tDiaryスキン)の使用法は BugTrack/769 を参照して下さい。
 120
 121 エラーが出る場合
 122     CGI版のPHPが設置されたサーバー(特にsuExecと組み合わされている環境)で動作
 123     させようとした場合に "Internal Server Error" などと表示される場合がありま
 124     す。詳しくはサーバー管理者がPHPスクリプト向けに提供している情報を確認して
 125     下さい。
 126
 127       1. 実行するPHPスクリプト(PukiWikiの場合 index.php か pukiwiki.php)の
 128         一行目に、PHPバイナリへのパスを追加する必要があるかもしれません。
 129         (例: #!/usr/local/bin/php)この値はサーバーにより異なります。
 130
 131       2. たいていの場合、より厳密なパーミッションが求められます。
 132
 133 エラーが出る場合: .htaccessファイル
 134     PukiWiki 1.4.4 から .htaccess ファイルを添付する様になっていますが、
 135     Apache Web サーバーの設定によっては "Internal Server Error" を起こす場合
 136     があります。
 137
 138     具体例:
 139       Webブラウザに "Internal Server Error" と表示され
 140       Webサーバーのエラーログには "order not allowed here" というエラーが記録
 141       される
 142
 143     これはPukiWikiを設置したい場所で .htaccess による設定変更が許可されていな
 144     い(特に "AllowOverride Limit" でない)のが原因です。
 145
 146     回避策: .htaccess、および skin/.htaccess を削除する
 147
 148     解決策：
 149       Apache設定ファイル(httpd.conf)の、PukiWikiを設置したいディレクトリに関
 150       する部分に "AllowOverride Limit" を追加する
 151
 152 エラーが出る場合: Parse error
 153     "Parse error: parse error, unexpected XXXX in .... on line NNN"
 154
 155     PHPスクリプトに矛盾がある場合、このようなメッセージが表示されます。指定さ
 156     れているファイルの、指定された行の付近をチェックし、問題があれば修正して
 157     下さい。理由としては以下のようなケースが考えられます。
 158
 159       1. 末尾にあったセミコロンを消してしまった
 160
 161       2. 文字列をシングルクォートかダブルクォートで囲むはずが、片方を消して
 162          しまった / 文字列の中に(文字列を囲んでいるのと同じ)シングルクォート
 163          やダブルクォートがある
 164
 165 エラーが出る場合: Runtime error
 166     Error message : Directory is not found or not writable (xxx_DIR)
 167
 168     データを書き込むディレクトリ(やファイル)に書き込み権限が無い場合、このよ
 169     うなメッセージを表示します。xxx_DIR がどこにあたるかは、設定ファイルで同
 170     名の定数を定義している部分を参照して下さい。
 171
 172 エラーが出る場合: CSSが動作しない
 173     pukiwiki.css.php は単独のPHPプログラムであるため、CGI起動が必要な環境で
 174     あったり、mod_layoutによる広告挿入回避を行う場合はこのファイルについても
 175     index.phpと同様の対応を行う必要があります。
 176
 177 バックアップとリストア
 178     ページの最新データを収めているディレクトリ(デフォルトの名前は wiki)以下
 179     を、また必要に応じて他のデータを収めているディレクトリ以下をバックアップし
 180     て下さい。(同 attach, backup, cache, counter, diff)
 181
 182     cacheディレクトリもバックアップすることをお薦めします。
 183     1. cache/*.rel ファイルと cache/*.ref ファイルは linksプラグイン で再生
 184        成可能ですが、この処理は非常に重く、環境によっては処理が必ず失敗する
 185        (中断する)場合があります。
 186     2. cache/*.rel ファイルがPukiWikiに全くない時に既存のページを編集すると、
 187       linksプラグインを実行した状態とほぼ同等の負荷がかかります。
 188       (詳細:BugTrack2/56)
 189     3. amazonプラグインはここに画像(のキャッシュ)を保存します。
 190
 191     データを配置した時は、ファイルのパーミッションが期待されている通りかどう
 192     か、また実際に動作するかどうかを確認して下さい。(例: 配置したページの更新
 193     を試みる)
 194
 195     PukiWiki 1.4.5 以降では、添付されている dumpプラグイン で、wiki/attach/
 196     backup ディレクトリのリモートバックアップ(*.tar.gzないし*.tar形式)が可能で
 197     す。
 198       起動の例: index.php?plugin=dump
 199
 200     dumpプラグインにはdumpプラグインで取得したファイルの中身をPukiWikiに展開す
 201     る機能(リモートリストア)も用意されています。ただしファイルに含まれていない
 202     データをPukiWikiから削除する機能はありません(常に上書きになります)し、Web
 203     サーバーやPHPのアップロードファイルサイズ制限を越えるファイルを利用するこ
 204     とはできません。またこの機能はデフォルトで無効になっています。
 205
 206     その他、PukiWikiの更新内容をメールで通知する機能は、既存のデータを失わない
 207     ための機能としてとらえる事ができるでしょう。