OSDN Git Service

BugTrack2/343 Replace 'htmlspecialchars' by 'htmlsc'
[pukiwiki/pukiwiki.git] / INSTALL.txt
index c994902..dfdf787 100755 (executable)
-̾Á°
-    PukiWiki  - ¼«Í³¤Ë¥Ú¡¼¥¸¤òÄɲᦺï½ü¡¦ÊÔ½¸¤Ç¤­¤ëWeb¥Ú¡¼¥¸¹½ÃÛ¥¹¥¯¥ê¥×¥È
+名前
+    PukiWiki  - 自由にページを追加・削除・編集できるWebページ構築スクリプト
 
-    Version 1.5.0
-    Copyright (C)
-      2001-2005 PukiWiki Developers Team
+    Version 1.5.1
+    Copyright
+      2001-2016 PukiWiki Development Team
       2001-2002 yu-ji (Based on PukiWiki 1.3 by yu-ji)
     License: GPL version 2 or (at your option) any later version
 
-    $Id: INSTALL.txt,v 1.8 2005/12/06 14:59:29 henoheno Exp $
+インストール
+    PukiWikiはPHPスクリプトであるため、(例えばPerlのように)スクリプトに実行権
+    を付ける必要はありません。CGI起動でないのであれば、スクリプトの一行目を修
+    正する必要もありません。
 
-¥¤¥ó¥¹¥È¡¼¥ë
-    PukiWiki¤ÏPHP¥¹¥¯¥ê¥×¥È¤Ç¤¢¤ë¤¿¤á¡¢(Î㤨¤ÐPerl¤Î¤è¤¦¤Ë)¥¹¥¯¥ê¥×¥È¤Ë¼Â¹Ô¸¢
-    ¤òÉÕ¤±¤ëɬÍפϤ¢¤ê¤Þ¤»¤ó¡£CGIµ¯Æ°¤Ç¤Ê¤¤¤Î¤Ç¤¢¤ì¤Ð¡¢¥¹¥¯¥ê¥×¥È¤Î°ì¹ÔÌܤò½¤
-    Àµ¤¹¤ëɬÍפ⤢¤ê¤Þ¤»¤ó¡£
+    Webサーバーへのシェルアクセスが可能であれば、PukiWikiのアーカイブをそのま
+    まサーバーに転送し、サーバー上で解凍(tar pzxf pukiwiki*.tar.gz) するだけ
+    でパーミッションの設定も行われ、すぐに使い始める事ができるでしょう。
 
-    Web¥µ¡¼¥Ð¡¼¤Ø¤Î¥·¥§¥ë¥¢¥¯¥»¥¹¤¬²Äǽ¤Ç¤¢¤ì¤Ð¡¢PukiWiki¤Î¥¢¡¼¥«¥¤¥Ö¤ò¤½¤Î¤Þ
-    ¤Þ¥µ¡¼¥Ð¡¼¤ËžÁ÷¤·¡¢¥µ¡¼¥Ð¡¼¾å¤Ç²òÅà(tar pzxf pukiwiki*.tar.gz) ¤¹¤ë¤À¤±
-    ¤Ç¥Ñ¡¼¥ß¥Ã¥·¥ç¥ó¤ÎÀßÄê¤â¹Ô¤ï¤ì¡¢¤¹¤°¤Ë»È¤¤»Ï¤á¤ë»ö¤¬¤Ç¤­¤ë¤Ç¤·¤ç¤¦¡£
+    スクリプトの中の日本語は(あれば、基本的に)UTF-8で、また改行コードはLFで
+    記述されています。スクリプトを直接編集する場合は、日本語文字コードと改行
+    コードの自動判別ができ、それを元のまま保存できるテキストエディタを使用し
+    て下さい。
 
-    ¥¹¥¯¥ê¥×¥È¤ÎÃæ¤ÎÆüËܸì¤Ï(¤¢¤ì¤Ð¡¢´ðËÜŪ¤Ë)EUC-JP¤Ç¡¢¤Þ¤¿²þ¹Ô¥³¡¼¥É¤ÏLF¤Ç
-    µ­½Ò¤µ¤ì¤Æ¤¤¤Þ¤¹¡£¥¹¥¯¥ê¥×¥È¤òľÀÜÊÔ½¸¤¹¤ë¾ì¹ç¤Ï¡¢ÆüËܸìʸ»ú¥³¡¼¥É¤È²þ¹Ô
-    ¥³¡¼¥É¤Î¼«Æ°È½Ê̤¬¤Ç¤­¡¢¤½¤ì¤ò¸µ¤Î¤Þ¤ÞÊݸ¤Ç¤­¤ë¥Æ¥­¥¹¥È¥¨¥Ç¥£¥¿¤ò»ÈÍѤ·
-    ¤Æ²¼¤µ¤¤¡£
+    以下に、事前にクライアントPCで作業を行う場合の例を記します。
 
-    °Ê²¼¤Ë¡¢»öÁ°¤Ë¥¯¥é¥¤¥¢¥ó¥ÈPC¤Çºî¶È¤ò¹Ô¤¦¾ì¹ç¤ÎÎã¤òµ­¤·¤Þ¤¹¡£
+    1. PukiWikiのアーカイブを展開します。
 
-    1. PukiWiki¤Î¥¢¡¼¥«¥¤¥Ö¤òŸ³«¤·¤Þ¤¹¡£
+    2. 設定ファイル(*.ini.php)の内容を確認します。何も修正せずとも動作します
+       が、公開された場所に設置するのであれば、念のため事前に管理者パスワード
+       を修正して下さい。
 
-    2. ÀßÄê¥Õ¥¡¥¤¥ë(*.ini.php)¤ÎÆâÍƤò³Îǧ¤·¤Þ¤¹¡£²¿¤â½¤Àµ¤»¤º¤È¤âÆ°ºî¤·¤Þ¤¹
-       ¤¬¡¢¸ø³«¤µ¤ì¤¿¾ì½ê¤ËÀßÃÖ¤¹¤ë¤Î¤Ç¤¢¤ì¤Ð¡¢Ç°¤Î¤¿¤á»öÁ°¤Ë´ÉÍý¼Ô¥Ñ¥¹¥ï¡¼¥É
-       ¤ò½¤Àµ¤·¤Æ²¼¤µ¤¤¡£
+       設定ファイルのほとんどの項目は pukiwiki.ini.php に集約されています。
 
-       ÀßÄê¥Õ¥¡¥¤¥ë¤Î¤Û¤È¤ó¤É¤Î¹àÌܤϠpukiwiki.ini.php ¤Ë½¸Ì󤵤ì¤Æ¤¤¤Þ¤¹¡£
+        全体設定           : pukiwiki.ini.php
+        ユーザ定義         : rules.ini.php
 
-        Á´ÂÎÀßÄê           : pukiwiki.ini.php
-        ¥æ¡¼¥¶ÄêµÁ         : rules.ini.php
+       その他、ユーザーエージェントごとの設定が用意されています。
 
-       ¤½¤Î¾¡¢¥æ¡¼¥¶¡¼¥¨¡¼¥¸¥§¥ó¥È¤´¤È¤ÎÀßÄ꤬ÍÑ°Õ¤µ¤ì¤Æ¤¤¤Þ¤¹¡£
+        デスクトップPC     : default.ini.php
+        携帯電話およびPDA  : keitai.ini.php
+           (旧 i_mode.ini.php/jphone.ini.php)
 
-        ¥Ç¥¹¥¯¥È¥Ã¥×PC     : default.ini.php
-        ·ÈÂÓÅÅÏ䪤è¤ÓPDA  : keitai.ini.php
-           (µì i_mode.ini.php/jphone.ini.php)
-
-      PukiWiki¤Î´ÉÍý¼Ô¥Ñ¥¹¥ï¡¼¥É¤Ï¡¢pukiwiki.ini.php ¤Ë¤¢¤ëÊÑ¿ô $adminpass
-      ¤Ç¤¹¡£´Êñ¤Ë»î¤¹¤À¤±¤Ç¤¢¤ë¤Ê¤é¤Ð¡¢°Ê²¼¤Î¤è¤¦¤ÊÆâÍƤǽ¼Ê¬¤Ç¤·¤ç¤¦¡£
-      ('YourPassWord' ¤ÎÉôʬ¤ò¡¢¤¢¤Ê¤¿¤À¤±¤Î¥­¡¼¥ï¡¼¥É¤ÇÃÖ¤­´¹¤¨¤Æ²¼¤µ¤¤)
+      PukiWikiの管理者パスワードは、pukiwiki.ini.php にある変数 $adminpass
+      です。簡単に試すだけであるならば、以下のような内容で充分でしょう。
+      ('YourPassWord' の部分を、あなただけのキーワードで置き換えて下さい)
 
          $adminpass = '{x-php-md5}' . md5('YourPassWord');
 
-      ¢¨ÀßÄê¤ò¡ÖÍ­¸ú¤Ë¤¹¤ë¡×¤È¤Ï¡¢Â¿¤¯¤Î¾ì¹ç¡¢ÀßÄêÃͤò¿ô»ú¤Î 0 ¤Ç¤Ê¤¤ÃÍ(Î㤨
-        ¤Ð1)¤Ë¤¹¤ë»ö¤Ç¤¹¡£°ìÉô¤ÎÀßÄê¤Ï̾Á°¤Ë DISABLE ¤Ê¤¤¤· $noXXX ¤È¤¢¤ê¤Þ¤¹
-        ¤¬¡¢¤½¤ì¤é¤ÏÃͤò 0 ¤Ç¤Ê¤¤¤â¤Î¤Ë¤¹¤ë¤³¤È¤Ç¡¢¤½¤ÎÀßÄêÃͤËÂбþ¤¹¤ëµ¡Ç½¤¬
-        Ìµ¸ú¤Ë¤Ê¤ê¤Þ¤¹¡£(̵¸ú¤Ë¤¹¤ëÌò³ä¤¬Í­¸ú¤Ë¤Ê¤ê¤Þ¤¹)
-
-      ¢¨¥¤¥ó¥¿¡¼¥Í¥Ã¥È¤Ë¸ø³«¤¹¤ëPukiWiki¤Ç¤¢¤ë¤Ê¤é¤Ð¡¢PKWK_SAFE_MODE ¤òÍ­¸ú¤Ë
-        ¤¹¤ë¤³¤È¤ò¤ªÁ¦¤á¤·¤Þ¤¹¡£(¾ÜºÙ:BugTrack/787)
-
-      ¢¨Â¾¿Í¤ËÊÔ½¸¤µ¤»¤Ê¤¤´Ä¶­¤ò¤´Í×˾¤Ç¤¢¤ì¤Ð¡¢PKWK_READONLY ¤òÍ­¸ú¤Ë¤¹¤ë¤³
-        ¤È¤ò¤ªÁ¦¤á¤·¤Þ¤¹¡£(¾ÜºÙ:BugTrack/744)
-
-    3.  ¥Õ¥¡¥¤¥ë¤òFTP¤Ê¤É¤Ç¥µ¡¼¥Ð¤ËžÁ÷¤·¤Þ¤¹¡£
-      ´ðËÜŪ¤Ë²¿¤ÎÊÑ´¹¤â¹Ô¤ï¤º¡¢¡Ö¤½¤Î¤Þ¤Þ¡×žÁ÷¤·¤Æ²¼¤µ¤¤
-      ¡¦¥Õ¥¡¥¤¥ë̾¤ä¡¢¥Õ¥¡¥¤¥ë̾¤ÎÂçʸ»ú¾®Ê¸»ú¤Ê¤É¤òÊѹ¹¤·¤Ê¤¤¤Ç²¼¤µ¤¤
-      ¡¦FTP¤ÎžÁ÷¥â¡¼¥É¤Ï¡Ö¥Ð¥¤¥Ê¥ê(bin)¡×¤ò»ÈÍѤ·¤Æ²¼¤µ¤¤
-
-    4.  ¥µ¡¼¥Ð¾å¤Î¥Õ¥¡¥¤¥ë¤ª¤è¤Ó¥Ç¥£¥ì¥¯¥È¥ê¤Î¥Ñ¡¼¥ß¥Ã¥·¥ç¥ó¤ò³Îǧ¤·¤Þ¤¹¡£
-
-    ¥Ç¥£¥ì¥¯¥È¥ê ¥Ñ¡¼¥ß¥Ã¥·¥ç¥ó
-      attach         777       ÅºÉÕ¥Õ¥¡¥¤¥ë³ÊǼ¥Ç¥£¥ì¥¯¥È¥ê
-      backup         777       ¥Ð¥Ã¥¯¥¢¥Ã¥×¥Õ¥¡¥¤¥ë³ÊǼ¥Ç¥£¥ì¥¯¥È¥ê
-      cache          777       ¥­¥ã¥Ã¥·¥å¥Õ¥¡¥¤¥ë³ÊǼ¥Ç¥£¥ì¥¯¥È¥ê
-      counter        777       ¥«¥¦¥ó¥¿¥Õ¥¡¥¤¥ë³ÊǼ¥Ç¥£¥ì¥¯¥È¥ê
-      diff           777       º¹Ê¬¥Õ¥¡¥¤¥ë³ÊǼ¥Ç¥£¥ì¥¯¥È¥ê
-      image          755       ²èÁü¥Õ¥¡¥¤¥ë
-      image/face     755       (²èÁü¥Õ¥¡¥¤¥ë)¥Õ¥§¥¤¥¹¥Þ¡¼¥¯  
-      lib            755       ¥é¥¤¥Ö¥é¥ê
-      plugin         755       ¥×¥é¥°¥¤¥ó
-      skin           755       ¥¹¥­¥ó¡¢CSS¡¢JavaScirpt¥Õ¥¡¥¤¥ë
-      trackback      777       TrackBack¥Õ¥¡¥¤¥ë³ÊǼ¥Ç¥£¥ì¥¯¥È¥ê
-      wiki           777       ¥Ç¡¼¥¿¤Î³ÊǼ¥Ç¥£¥ì¥¯¥È¥ê
-
-    ¥Õ¥¡¥¤¥ë    ¥Ñ¡¼¥ß¥Ã¥·¥ç¥ó ¥Ç¡¼¥¿¤Î¼ïÎà(»²¹Í)
+      ※設定を「有効にする」とは、多くの場合、設定値を数字の 0 でない値(例え
+        ば1)にする事です。一部の設定は名前に DISABLE ないし $noXXX とあります
+        が、それらは値を 0 でないものにすることで、その設定値に対応する機能が
+        無効になります。(無効にする役割が有効になります)
+
+      ※インターネットに公開するPukiWikiであるならば、PKWK_SAFE_MODE を有効に
+        することをお薦めします。(詳細:BugTrack/787)
+
+      ※他人に編集させない環境をご要望であれば、PKWK_READONLY を有効にするこ
+        とをお薦めします。(詳細:BugTrack/744)
+
+    3.  ファイルをFTPなどでサーバに転送します。
+      基本的に何の変換も行わず、「そのまま」転送して下さい
+      ・ファイル名や、ファイル名の大文字小文字などを変更しないで下さい
+      ・FTPの転送モードは「バイナリ(bin)」を使用して下さい
+
+    4.  サーバ上のファイルおよびディレクトリのパーミッションを確認します。
+
+    ディレクトリ パーミッション
+      attach         777       添付ファイル格納ディレクトリ
+      backup         777       バックアップファイル格納ディレクトリ
+      cache          777       キャッシュファイル格納ディレクトリ
+      counter        777       カウンタファイル格納ディレクトリ
+      diff           777       差分ファイル格納ディレクトリ
+      image          755       画像ファイル
+      image/face     755       (画像ファイル)フェイスマーク  
+      lib            755       ライブラリ
+      plugin         755       プラグイン
+      skin           755       スキン、CSS、JavaScirptファイル
+      wiki           777       データの格納ディレクトリ
+
+    ファイル    パーミッション データの種類(参考)
       .htaccess      644       ASCII
       .htpasswd      644       ASCII
       */.htaccess    644       ASCII
 
-    ¥Õ¥¡¥¤¥ë    ¥Ñ¡¼¥ß¥Ã¥·¥ç¥ó ¥Ç¡¼¥¿¤Î¼ïÎà(»²¹Í)
+    ファイル    パーミッション データの種類(参考)
       *.php          644       ASCII
       */*.php        644       ASCII
-      attach/*       666       BINARY (¤Ï¤¸¤á¤Ï¸ºß¤»¤º)
-      backup/*.gz    666       BINARY (¥¤¥ó¥¹¥È¡¼¥ë»þ¤Ï¸ºß¤»¤º)
-      backup/*.txt   666       ASCII  (¿¤¯¤Î´Ä¶­¤Ç¤Ï¸ºß¤»¤º)
+      attach/*       666       BINARY (はじめは存在せず)
+      backup/*.gz    666       BINARY (インストール時は存在せず)
+      backup/*.txt   666       ASCII  (多くの環境では存在せず)
       cache/*        666       ASCII
-        (°ìÉô¤Î¥×¥é¥°¥¤¥ó¤Ï¥Ð¥¤¥Ê¥ê¥Õ¥¡¥¤¥ë¤òÊݸ¤·¤Þ¤¹)
-      counter/*      666       ASCII  (¤Ï¤¸¤á¤Ï¸ºß¤»¤º)
-      diff/*.txt     666       ASCII  (¤Ï¤¸¤á¤Ï¸ºß¤»¤º)
+        (一部のプラグインはバイナリファイルを保存します)
+      counter/*      666       ASCII  (はじめは存在せず)
+      diff/*.txt     666       ASCII  (はじめは存在せず)
       wiki/*.txt     666       ASCII
       image/*        644       BINARY
       image/face/*   644       BINARY
       plugin/*       644       ASCII
       skin/*         644       ASCII
 
-    5. ¥µ¡¼¥Ð¡¼¤ËÀßÃÖ¤·¤¿ PukiWiki ¤Î index.php ¤¢¤ë¤¤¤Ï pukiwiki.php ¤Ë¡¢Web
-      ¥Ö¥é¥¦¥¶¤«¤é¥¢¥¯¥»¥¹¤·¡¢PukiWiki¤¬Æ°ºî¤¹¤ë¤«ÍͻҤò¸«¤Þ¤¹¡£
+    5. サーバーに設置した PukiWiki の index.php あるいは pukiwiki.php に、Web
+      ブラウザからアクセスし、PukiWikiが動作するか様子を見ます。
 
-      ¢¨¥¨¥é¡¼¤¬½Ð¤ë¾ì¹ç: ²¼µ­¤ò»²¾È¤·¤Æ²¼¤µ¤¤
+      ※エラーが出る場合: 下記を参照して下さい
 
-    6.  É¬Íפ˱þ¤¸¤Æ¡¢¤µ¤é¤ËÀßÄê¤ä¥Ç¥¶¥¤¥ó¤òÄ´À°¤·¤Æ²¼¤µ¤¤¡£
+    6.  必要に応じて、さらに設定やデザインを調整して下さい。
 
-      ¢¨CSS(³°¸«)¤Ï skin/¥¹¥­¥ó̾.css.php ¤Ë¤¢¤ê¤Þ¤¹¡£¤³¤ì¤ÏÌÜŪ¤Ë±þ¤¸¤¿CSS¤ò
-        ½ÐÎϤ¹¤ë¤³¤È¤Î¤Ç¤­¤ë¡¢Ã±ÆȤÎPHP¥¹¥¯¥ê¥×¥È¤Ç¤¹¡£¤³¤ì¤òÀÅŪ¤Ê¥Õ¥¡¥¤¥ë¤Ë
-        ¤·¤¿¤¤¾ì¹ç¤Ï¡¢Web¥Ö¥é¥¦¥¶¤Ç½ÐÎÏ·ë²Ì¤ò¼è¤ê½Ð¤·¤Æ²¼¤µ¤¤¡£¤É¤Î¤è¤¦¤ÊCSS
-        ¤¬µá¤á¤é¤ì¤Æ¤¤¤ë¤«¤Ï¥¹¥­¥ó¤Ëµ­½Ò¤µ¤ì¤Æ¤¤¤Þ¤¹¡£
-      ¢¨¥¹¥­¥ó(³°¸«¤Î¹üÁȤß)¤Ë´Ø¤¹¤ëÀßÄê¹àÌܤϠskin/¥¹¥­¥ó̾.skin.php ¤ÎÀèƬ¤Ë
-        ¤¢¤ê¤Þ¤¹¡£
-      ¢¨¥×¥é¥°¥¤¥óÆȼ«¤ÎÀßÄê¹àÌܤϠplugin/¥×¥é¥°¥¤¥ó̾.inc.php ¤ÎÀèƬ¤Ë¤¢¤ê¤Þ
-        ¤¹
-      ¢¨tDiary¥Æ¡¼¥Þ(tDiary¥¹¥­¥ó)¤Î»ÈÍÑË¡¤Ï BugTrack/769 ¤ò»²¾È¤·¤Æ²¼¤µ¤¤¡£
+      ※CSS(外見)は skin/スキン名.css.php にあります。これは目的に応じたCSSを
+        出力することのできる、単独のPHPスクリプトです。これを静的なファイルに
+        したい場合は、Webブラウザで出力結果を取り出して下さい。どのようなCSS
+        が求められているかはスキンに記述されています。
+      ※スキン(外見の骨組み)に関する設定項目は skin/スキン名.skin.php の先頭に
+        あります。
+      ※プラグイン独自の設定項目は plugin/プラグイン名.inc.php の先頭にありま
+        す
+      ※tDiaryテーマ(tDiaryスキン)の使用法は BugTrack/769 を参照して下さい。
 
-¥¨¥é¡¼¤¬½Ð¤ë¾ì¹ç
-    CGIÈǤÎPHP¤¬ÀßÃÖ¤µ¤ì¤¿¥µ¡¼¥Ð¡¼(ÆäËsuExec¤ÈÁȤ߹ç¤ï¤µ¤ì¤Æ¤¤¤ë´Ä¶­)¤ÇÆ°ºî
-    ¤µ¤»¤è¤¦¤È¤·¤¿¾ì¹ç¤Ë "Internal Server Error" ¤Ê¤É¤Èɽ¼¨¤µ¤ì¤ë¾ì¹ç¤¬¤¢¤ê¤Þ
-    ¤¹¡£¾Ü¤·¤¯¤Ï¥µ¡¼¥Ð¡¼´ÉÍý¼Ô¤¬PHP¥¹¥¯¥ê¥×¥È¸þ¤±¤ËÄ󶡤·¤Æ¤¤¤ë¾ðÊó¤ò³Îǧ¤·¤Æ
-    ²¼¤µ¤¤¡£
+エラーが出る場合
+    CGI版のPHPが設置されたサーバー(特にsuExecと組み合わされている環境)で動作
+    させようとした場合に "Internal Server Error" などと表示される場合がありま
+    す。詳しくはサーバー管理者がPHPスクリプト向けに提供している情報を確認して
+    下さい。
 
-      1. ¼Â¹Ô¤¹¤ëPHP¥¹¥¯¥ê¥×¥È(PukiWiki¤Î¾ì¹ç index.php ¤« pukiwiki.php)¤Î
-        °ì¹ÔÌܤˡ¢PHP¥Ð¥¤¥Ê¥ê¤Ø¤Î¥Ñ¥¹¤òÄɲ乤ëɬÍפ¬¤¢¤ë¤«¤â¤·¤ì¤Þ¤»¤ó¡£
-        (Îã: #!/usr/local/bin/php)¤³¤ÎÃͤϥµ¡¼¥Ð¡¼¤Ë¤è¤ê°Û¤Ê¤ê¤Þ¤¹¡£
+      1. 実行するPHPスクリプト(PukiWikiの場合 index.php か pukiwiki.php)の
+        一行目に、PHPバイナリへのパスを追加する必要があるかもしれません。
+        (例: #!/usr/local/bin/php)この値はサーバーにより異なります。
 
-      2. ¤¿¤¤¤Æ¤¤¤Î¾ì¹ç¡¢¤è¤ê¸·Ì©¤Ê¥Ñ¡¼¥ß¥Ã¥·¥ç¥ó¤¬µá¤á¤é¤ì¤Þ¤¹¡£
+      2. たいていの場合、より厳密なパーミッションが求められます。
 
-¥¨¥é¡¼¤¬½Ð¤ë¾ì¹ç: .htaccess¥Õ¥¡¥¤¥ë
-    PukiWiki 1.4.4 ¤«¤é .htaccess ¥Õ¥¡¥¤¥ë¤òźÉÕ¤¹¤ëÍͤˤʤäƤ¤¤Þ¤¹¤¬¡¢
-    Apache Web ¥µ¡¼¥Ð¡¼¤ÎÀßÄê¤Ë¤è¤Ã¤Æ¤Ï "Internal Server Error" ¤òµ¯¤³¤¹¾ì¹ç
-    ¤¬¤¢¤ê¤Þ¤¹¡£
+エラーが出る場合: .htaccessファイル
+    PukiWiki 1.4.4 から .htaccess ファイルを添付する様になっていますが、
+    Apache Web サーバーの設定によっては "Internal Server Error" を起こす場合
+    があります。
 
-    ¶ñÂÎÎã:
-      Web¥Ö¥é¥¦¥¶¤Ë "Internal Server Error" ¤Èɽ¼¨¤µ¤ì
-      Web¥µ¡¼¥Ð¡¼¤Î¥¨¥é¡¼¥í¥°¤Ë¤Ï "order not allowed here" ¤È¤¤¤¦¥¨¥é¡¼¤¬µ­Ï¿
-      ¤µ¤ì¤ë
+    具体例:
+      Webブラウザに "Internal Server Error" と表示され
+      Webサーバーのエラーログには "order not allowed here" というエラーが記録
+      される
 
-    ¤³¤ì¤ÏPukiWiki¤òÀßÃÖ¤·¤¿¤¤¾ì½ê¤Ç .htaccess ¤Ë¤è¤ëÀßÄêÊѹ¹¤¬µö²Ä¤µ¤ì¤Æ¤¤¤Ê
-    ¤¤(Æäˠ"AllowOverride Limit" ¤Ç¤Ê¤¤)¤Î¤¬¸¶°ø¤Ç¤¹¡£
+    これはPukiWikiを設置したい場所で .htaccess による設定変更が許可されていな
+    い(特に "AllowOverride Limit" でない)のが原因です。
 
-    ²óÈòºö: .htaccess¡¢¤ª¤è¤Ó skin/.htaccess ¤òºï½ü¤¹¤ë
+    回避策: .htaccess、および skin/.htaccess を削除する
 
-    ²ò·èºö¡§
-      ApacheÀßÄê¥Õ¥¡¥¤¥ë(httpd.conf)¤Î¡¢PukiWiki¤òÀßÃÖ¤·¤¿¤¤¥Ç¥£¥ì¥¯¥È¥ê¤Ë´Ø
-      ¤¹¤ëÉôʬ¤Ë "AllowOverride Limit" ¤òÄɲ乤ë
+    解決策:
+      Apache設定ファイル(httpd.conf)の、PukiWikiを設置したいディレクトリに関
+      する部分に "AllowOverride Limit" を追加する
 
-¥¨¥é¡¼¤¬½Ð¤ë¾ì¹ç: Parse error
+エラーが出る場合: Parse error
     "Parse error: parse error, unexpected XXXX in .... on line NNN"
 
-    PHP¥¹¥¯¥ê¥×¥È¤ËÌ·½â¤¬¤¢¤ë¾ì¹ç¡¢¤³¤Î¤è¤¦¤Ê¥á¥Ã¥»¡¼¥¸¤¬É½¼¨¤µ¤ì¤Þ¤¹¡£»ØÄꤵ
-    ¤ì¤Æ¤¤¤ë¥Õ¥¡¥¤¥ë¤Î¡¢»ØÄꤵ¤ì¤¿¹Ô¤ÎÉÕ¶á¤ò¥Á¥§¥Ã¥¯¤·¡¢ÌäÂ꤬¤¢¤ì¤Ð½¤Àµ¤·¤Æ
-    ²¼¤µ¤¤¡£Íýͳ¤È¤·¤Æ¤Ï°Ê²¼¤Î¤è¤¦¤Ê¥±¡¼¥¹¤¬¹Í¤¨¤é¤ì¤Þ¤¹¡£
+    PHPスクリプトに矛盾がある場合、このようなメッセージが表示されます。指定さ
+    れているファイルの、指定された行の付近をチェックし、問題があれば修正して
+    下さい。理由としては以下のようなケースが考えられます。
 
-      1. ËöÈø¤Ë¤¢¤Ã¤¿¥»¥ß¥³¥í¥ó¤ò¾Ã¤·¤Æ¤·¤Þ¤Ã¤¿
+      1. 末尾にあったセミコロンを消してしまった
 
-      2. Ê¸»úÎó¤ò¥·¥ó¥°¥ë¥¯¥©¡¼¥È¤«¥À¥Ö¥ë¥¯¥©¡¼¥È¤Ç°Ï¤à¤Ï¤º¤¬¡¢ÊÒÊý¤ò¾Ã¤·¤Æ
-         ¤·¤Þ¤Ã¤¿ / Ê¸»úÎó¤ÎÃæ¤Ë(ʸ»úÎó¤ò°Ï¤ó¤Ç¤¤¤ë¤Î¤ÈƱ¤¸)¥·¥ó¥°¥ë¥¯¥©¡¼¥È
-         ¤ä¥À¥Ö¥ë¥¯¥©¡¼¥È¤¬¤¢¤ë
+      2. 文字列をシングルクォートかダブルクォートで囲むはずが、片方を消して
+         しまった / 文字列の中に(文字列を囲んでいるのと同じ)シングルクォート
+         やダブルクォートがある
 
-¥¨¥é¡¼¤¬½Ð¤ë¾ì¹ç: Runtime error
+エラーが出る場合: Runtime error
     Error message : Directory is not found or not writable (xxx_DIR)
 
-    ¥Ç¡¼¥¿¤ò½ñ¤­¹þ¤à¥Ç¥£¥ì¥¯¥È¥ê(¤ä¥Õ¥¡¥¤¥ë)¤Ë½ñ¤­¹þ¤ß¸¢¸Â¤¬Ìµ¤¤¾ì¹ç¡¢¤³¤Î¤è
-    ¤¦¤Ê¥á¥Ã¥»¡¼¥¸¤òɽ¼¨¤·¤Þ¤¹¡£xxx_DIR ¤¬¤É¤³¤Ë¤¢¤¿¤ë¤«¤Ï¡¢ÀßÄê¥Õ¥¡¥¤¥ë¤ÇƱ
-    Ì¾¤ÎÄê¿ô¤òÄêµÁ¤·¤Æ¤¤¤ëÉôʬ¤ò»²¾È¤·¤Æ²¼¤µ¤¤¡£
-
-¥¨¥é¡¼¤¬½Ð¤ë¾ì¹ç: CSS¤¬Æ°ºî¤·¤Ê¤¤
-    pukiwiki.css.php ¤ÏñÆȤÎPHP¥×¥í¥°¥é¥à¤Ç¤¢¤ë¤¿¤á¡¢CGIµ¯Æ°¤¬É¬ÍפʴĶ­¤Ç
-    ¤¢¤Ã¤¿¤ê¡¢mod_layout¤Ë¤è¤ë¹­¹ðÁÞÆþ²óÈò¤ò¹Ô¤¦¾ì¹ç¤Ï¤³¤Î¥Õ¥¡¥¤¥ë¤Ë¤Ä¤¤¤Æ¤â
-    index.php¤ÈƱÍͤÎÂбþ¤ò¹Ô¤¦É¬Íפ¬¤¢¤ê¤Þ¤¹¡£
-
-¥Ð¥Ã¥¯¥¢¥Ã¥×¤È¥ê¥¹¥È¥¢
-    ¥Ú¡¼¥¸¤ÎºÇ¿·¥Ç¡¼¥¿¤ò¼ý¤á¤Æ¤¤¤ë¥Ç¥£¥ì¥¯¥È¥ê(¥Ç¥Õ¥©¥ë¥È¤Î̾Á°¤Ï wiki)°Ê²¼
-    ¤ò¡¢¤Þ¤¿É¬Íפ˱þ¤¸¤Æ¾¤Î¥Ç¡¼¥¿¤ò¼ý¤á¤Æ¤¤¤ë¥Ç¥£¥ì¥¯¥È¥ê°Ê²¼¤ò¥Ð¥Ã¥¯¥¢¥Ã¥×¤·
-    ¤Æ²¼¤µ¤¤¡£(Ʊ attach, backup, cache, counter, diff, trackback)
-
-    cache¥Ç¥£¥ì¥¯¥È¥ê¤â¥Ð¥Ã¥¯¥¢¥Ã¥×¤¹¤ë¤³¤È¤ò¤ªÁ¦¤á¤·¤Þ¤¹¡£
-    1. cache/*.rel ¥Õ¥¡¥¤¥ë¤È cache/*.ref ¥Õ¥¡¥¤¥ë¤Ï links¥×¥é¥°¥¤¥ó ¤ÇºÆÀ¸
-       À®²Äǽ¤Ç¤¹¤¬¡¢¤³¤Î½èÍý¤ÏÈó¾ï¤Ë½Å¤¯¡¢´Ä¶­¤Ë¤è¤Ã¤Æ¤Ï½èÍý¤¬É¬¤º¼ºÇÔ¤¹¤ë
-       (ÃæÃǤ¹¤ë)¾ì¹ç¤¬¤¢¤ê¤Þ¤¹¡£
-    2. cache/*.rel ¥Õ¥¡¥¤¥ë¤¬PukiWiki¤ËÁ´¤¯¤Ê¤¤»þ¤Ë´û¸¤Î¥Ú¡¼¥¸¤òÊÔ½¸¤¹¤ë¤È¡¢
-      links¥×¥é¥°¥¤¥ó¤ò¼Â¹Ô¤·¤¿¾õÂ֤ȤۤÜƱÅù¤ÎÉé²Ù¤¬¤«¤«¤ê¤Þ¤¹¡£
-      (¾ÜºÙ:BugTrack2/56)
-    3. amazon¥×¥é¥°¥¤¥ó¤Ï¤³¤³¤Ë²èÁü(¤Î¥­¥ã¥Ã¥·¥å)¤òÊݸ¤·¤Þ¤¹¡£
-
-    ¥Ç¡¼¥¿¤òÇÛÃÖ¤·¤¿»þ¤Ï¡¢¥Õ¥¡¥¤¥ë¤Î¥Ñ¡¼¥ß¥Ã¥·¥ç¥ó¤¬´üÂÔ¤µ¤ì¤Æ¤¤¤ëÄ̤꤫¤É¤¦
-    ¤«¡¢¤Þ¤¿¼ÂºÝ¤ËÆ°ºî¤¹¤ë¤«¤É¤¦¤«¤ò³Îǧ¤·¤Æ²¼¤µ¤¤¡£(Îã: ÇÛÃÖ¤·¤¿¥Ú¡¼¥¸¤Î¹¹¿·
-    ¤ò»î¤ß¤ë)
-
-    PukiWiki 1.4.5 °Ê¹ß¤Ç¤Ï¡¢ÅºÉÕ¤µ¤ì¤Æ¤¤¤ë dump¥×¥é¥°¥¤¥ó ¤Ç¡¢wiki/attach/
-    backup ¥Ç¥£¥ì¥¯¥È¥ê¤Î¥ê¥â¡¼¥È¥Ð¥Ã¥¯¥¢¥Ã¥×(*.tar.gz¤Ê¤¤¤·*.tar·Á¼°)¤¬²Äǽ¤Ç
-    ¤¹¡£
-      µ¯Æ°¤ÎÎã: index.php?plugin=dump
-
-    dump¥×¥é¥°¥¤¥ó¤Ë¤Ïdump¥×¥é¥°¥¤¥ó¤Ç¼èÆÀ¤·¤¿¥Õ¥¡¥¤¥ë¤ÎÃæ¿È¤òPukiWiki¤ËŸ³«¤¹
-    ¤ëµ¡Ç½(¥ê¥â¡¼¥È¥ê¥¹¥È¥¢)¤âÍÑ°Õ¤µ¤ì¤Æ¤¤¤Þ¤¹¡£¤¿¤À¤·¥Õ¥¡¥¤¥ë¤Ë´Þ¤Þ¤ì¤Æ¤¤¤Ê¤¤
-    ¥Ç¡¼¥¿¤òPukiWiki¤«¤éºï½ü¤¹¤ëµ¡Ç½¤Ï¤¢¤ê¤Þ¤»¤ó(¾ï¤Ë¾å½ñ¤­¤Ë¤Ê¤ê¤Þ¤¹)¤·¡¢Web
-    ¥µ¡¼¥Ð¡¼¤äPHP¤Î¥¢¥Ã¥×¥í¡¼¥É¥Õ¥¡¥¤¥ë¥µ¥¤¥ºÀ©¸Â¤ò±Û¤¨¤ë¥Õ¥¡¥¤¥ë¤òÍøÍѤ¹¤ë¤³
-    ¤È¤Ï¤Ç¤­¤Þ¤»¤ó¡£¤Þ¤¿¤³¤Îµ¡Ç½¤Ï¥Ç¥Õ¥©¥ë¥È¤Ç̵¸ú¤Ë¤Ê¤Ã¤Æ¤¤¤Þ¤¹¡£
-
-    ¤½¤Î¾¡¢PukiWiki¤Î¹¹¿·ÆâÍƤò¥á¡¼¥ë¤ÇÄÌÃΤ¹¤ëµ¡Ç½¤Ï¡¢´û¸¤Î¥Ç¡¼¥¿¤ò¼º¤ï¤Ê¤¤
-    ¤¿¤á¤Îµ¡Ç½¤È¤·¤Æ¤È¤é¤¨¤ë»ö¤¬¤Ç¤­¤ë¤Ç¤·¤ç¤¦¡£
+    データを書き込むディレクトリ(やファイル)に書き込み権限が無い場合、このよ
+    うなメッセージを表示します。xxx_DIR がどこにあたるかは、設定ファイルで同
+    名の定数を定義している部分を参照して下さい。
+
+エラーが出る場合: CSSが動作しない
+    pukiwiki.css.php は単独のPHPプログラムであるため、CGI起動が必要な環境で
+    あったり、mod_layoutによる広告挿入回避を行う場合はこのファイルについても
+    index.phpと同様の対応を行う必要があります。
+
+ã\83\90ã\83\83ã\82¯ã\82¢ã\83\83ã\83\97ã\81¨ã\83ªã\82¹ã\83\88ã\82¢
+    ページの最新データを収めているディレクトリ(デフォルトの名前は wiki)以下
+    を、また必要に応じて他のデータを収めているディレクトリ以下をバックアップし
+    て下さい。(同 attach, backup, cache, counter, diff)
+
+    cacheディレクトリもバックアップすることをお薦めします。
+    1. cache/*.rel ファイルと cache/*.ref ファイルは linksプラグイン で再生
+       成可能ですが、この処理は非常に重く、環境によっては処理が必ず失敗する
+       (中断する)場合があります。
+    2. cache/*.rel ファイルがPukiWikiに全くない時に既存のページを編集すると、
+      linksプラグインを実行した状態とほぼ同等の負荷がかかります。
+      (詳細:BugTrack2/56)
+    3. amazonプラグインはここに画像(のキャッシュ)を保存します。
+
+    データを配置した時は、ファイルのパーミッションが期待されている通りかどう
+    か、また実際に動作するかどうかを確認して下さい。(例: 配置したページの更新
+    を試みる)
+
+    PukiWiki 1.4.5 以降では、添付されている dumpプラグイン で、wiki/attach/
+    backup ディレクトリのリモートバックアップ(*.tar.gzないし*.tar形式)が可能で
+    す。
+      起動の例: index.php?plugin=dump
+
+    dumpプラグインにはdumpプラグインで取得したファイルの中身をPukiWikiに展開す
+    る機能(リモートリストア)も用意されています。ただしファイルに含まれていない
+    データをPukiWikiから削除する機能はありません(常に上書きになります)し、Web
+    サーバーやPHPのアップロードファイルサイズ制限を越えるファイルを利用するこ
+    とはできません。またこの機能はデフォルトで無効になっています。
+
+    その他、PukiWikiの更新内容をメールで通知する機能は、既存のデータを失わない
+    ための機能としてとらえる事ができるでしょう。