--------------------------------------------------------
 PositLog インストールマニュアル

 Copyright (c) 2006 久保田 秀和 (疏水 太郎) All right reserved
  <taro@summer.nifty.jp>
   http://storybook.jp/

 Change Log:

 2006-08-07 version 0.3
 2006-07-30 version 0.2
 2006-07-23 version 0.2b
 2006-06-05 version 0.1
--------------------------------------------------------

１．はじめに

本文書ではPositLogの新規インストール方法について説明します．

(version 0.2 からのユーザの方は，配布アーカイブに同梱されている
 PositLog02to03.txt も必ずご覧ください．)


２．インストールのために必要な環境

PositLogはCGIプログラムであり，以下の条件を全て満たすサーバ環境で動作します．

・Perl 5.8 以上の動作するサーバ
　（よりバージョンの古いPerlでも動作するかもしれませんが，
　　おそらくCPAN（Perlモジュールが多数登録されている有名サイト）経由で
　　モジュールを追加する必要があります．）
・flock()に対応したサーバ（ほとんどのサーバが対応していると思います）

環境ではありませんが，PerlとCGIの設定に関する基本的な知識も必要です．


３．インストールの手順

　html://xxx.com/ があなたのサイトのルートURLで，
　html://xxx.com/positlog/positlog.cgi... 　というURLでPositLogへアクセスしたい場合，
　html://xxx.com/positlog/ をPositLogのルートURL
　html://xxx.com/positlog/system/ をPositLogのシステムURLと呼びます．
　
　また，PositLogのルートURLに対応するサーバ上のディレクトリを
　PositLogのルートディレクトリと呼びます．
　同様に，PositLogのシステムURLに対応するサーバ上のディレクトリを
　PositLogのシステムディレクトリと呼びます．

手順１
　配布ファイル positlog03.zip を解凍してください．
　positlog03 というディレクトリ（フォルダ）が作成されます．
　
手順２
　positlog03 ディレクトリにある PositLogConfig.pm を環境に合わせて変更してください．
 
手順３
　positlog03 ディレクトリ内の .cgi ファイルと .pmファイルを
　PositLogのルートディレクトリへ移動（あるいはアップロード）
　してください．
　
　移動すべきファイルと，パーミッション設定は次のようになります．
　PositLogルートディレクトリ（755）
　|- createadmin.cgi（755）
　|- createPage.cgi（755）
　|- createSprite.cgi（755）
　|- deleteSprite.cgi（755）
　|- pagemanager.cgi（755）
　|- pageproperty.cgi（755）
　|- positlog.cgi（755）
　|- positlogadmin.cgi（755）
　|- recentcontents.cgi（755）
　|- PositLogConfig.pm（644）
　|- saveSprite.cgi（755）
　|- saveStyles.cgi（755）
　|- usermanager.cgi（755）

　PositLogConfig.pm が他の人に読まれることはあまりよくありません．
　可能であるならば，PositLogルートディレクトリに
　以下の設定を記述した .htaccess という名前のファイルを設置してください．

　AddHandler cgi-script dat spr pm

　（.datはページの設定ファイル名，.sprはスプライトのファイル名の拡張子ですが，
　　ここで一緒に設定しておきます．
　　ただし，サーバの設定によってはこのやり方は無効かもしれません．）

手順４
　手順１で PositLogのシステムディレクトリとして設定したディレクトリを
　サーバ上に作成して，positlog03/system/ ディレクトリ内のファイルを全て
　そこへ移動（アップロード）してください．
　ディレクトリのパーミッションは755，ファイルのパーミッションは644にしてください．

手順５
　手順１で ページデータ保存用データ保存用ディレクトリ（$datapath）として設定した
　ディレクトリをサーバ上に作成して，CGIから書き込めるようにパーミッションを与えてください．
　おそらくは755で良いかと思います．

手順６
　手順１で 背景画像保存用データ保存用ディレクトリ（$bgimagespath）として設定した
　ディレクトリをサーバ上に作成して，CGIから書き込めるようにパーミッションを与えてください．
　おそらくは755で良いかと思います．

手順７
　手順１で 管理用データ保存用ディレクトリ（$adminpath）として設定した
　ディレクトリをサーバ上に作成して，CGIから書き込めるようにパーミッションを与えてください．
　おそらくは755で良いかと思います．

手順８
　positlog03 ディレクトリ内の
　・HTTPディレクトリ
　・PositLogPluginディレクトリ
　をPositLogのルートディレクトリへ移動（アップロード）してください．

手順９
　createadmin.cgi をWebブラウザ上で開いてください．管理者（admin）のユーザ名とパスワードを入力し，[Create] ボタンを押してください．管理者の認証データとして，管理用データ保存用ディレクトリ（$adminpath）の下に key.cgi というファイルが作成されます．
　作成後，createadmin.cgiファイルはサーバから削除してください．
　管理者のユーザ名あるいはパスワードを忘れた際は，key.cgiを削除し，createadmin.cgiを再びアップロード，実行してください．

=====================================================
以上で完了です．お疲れ様でした．


PositLog 0.3 は次のようにして開始します．

手順１
　positlogadmin.cgi をWebブラウザ上で開いてください．
　ログイン画面が表示されますので，先ほどの管理者のユーザ名とパスワードを入力し，
　[Login] ボタンを押してください．管理画面へログインできます．

手順２
　管理画面から，User Management画面　および　Page Management画面へ入ることができます．
　一人で利用する場合，User Managementは使う必要がありません．
　Page Management 画面では，新しいページの作成，設定，削除を行うことが出来ます．

　まずはページを作成しましょう．
　
　あとはWeb版のマニュアルをご覧下さい．
　http://storybook.jp/positlog.cgi?load=060727eh
　


