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

 Copyright (c) 2006-2008 久保田 秀和 All right reserved
  <hidekaz@positlog.org>
   http://positlog.org/

 Change Log:

 2008-02-02 version 0.6rc1
 2008-01-29 version 0.6b6
 2008-01-15 version 0.6b5
 2008-01-14 version 0.6b4
 2008-01-06 version 0.6b3
 2007-12-26 version 0.6b2
 2007-12-16 version 0.6b1
 2007-08-22 version 0.583
 2007-04-23 version 0.5
 2006-11-22 version 0.4
 2006-08-07 version 0.3
 2006-07-30 version 0.2
 2006-06-05 version 0.1
===========================================================

--------------------------------------------------------
--------------------------------------------------------
１．はじめに
--------------------------------------------------------
--------------------------------------------------------

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

- 新規インストールではなく0.583からのアップグレードの場合，ver0583to060.txtの指示に従って下さい．

- 0.60b3,b4,b5,b6からのアップグレードの場合，ver060b6to060rc1.txtの指示に従ってください．

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

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

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

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


・CGI専用のディレクトリを定めているサーバ（ScriptAlias利用）は，PositLogの正式サポート外としています．このため，一部，そのままでは動作しない機能があります．また，インストール方法も本文書とは異なる部分があります．該当する場合は本文書に一通り目を通した後，scriptalias.txt を参考にしながら設置してください．scriptalias.txt に挙げたものはあくまで参考例なので，いくらか修正する必要があると思います．


--------------------------------------------------------
--------------------------------------------------------
３．Perlのインストールパス確認
--------------------------------------------------------
--------------------------------------------------------

　PositLogではPerlが次のパスにインストールされているという前提で製作されています．

　/usr/bin/perl

　別の場所の場合は，同梱の .cgi ファイル全てについて，
　冒頭部に記述された Perl のパスを変更してください．


--------------------------------------------------------
--------------------------------------------------------
４．インストールの手順
--------------------------------------------------------
--------------------------------------------------------

　サーバ上のWWWでアクセス可能な場所にPositLog用のディレクトリを一つ用意してください．
　（例）/var/www/html/positlog/
　これをPositLogのルートディレクトリと呼びます．
　PositLog以外には何も置かれていないほうがよいと思います．

　PositLogのルートディレクトリに対応するURLをルートURLと呼びます．
　（例）html://xxx.com/positlog/


　また，以下では次のような意味合いでパーミッションを記述しています．

　777 : CGIが実行される権限によって書き込み可能
　755 : CGIが実行される権限によって実行可能
　644 : CGIが実行される権限によって読み取り可能

　パーミッションについては，サーバ環境とセキュリティポリシーに応じて適宜変更してください．
　レンタルサーバを利用している場合は特に，プロバイダによるCGI設定の際の注意書きを確認してください．

----------------------------------------
(1) アーカイブを解凍
----------------------------------------

　頒布ファイル positlog060rc1.zip を解凍してください．
　positlog060rc1 というディレクトリ（フォルダ）が作成されます．


----------------------------------------
(2) PositLogConfig.pm を設定，設置
----------------------------------------

　positlog060rc1/document/Japanese/ ディレクトリにある PositLogConfig.pm を開いて，
　ルートURL（$rooturl）を設定してください．
　最低限これだけでも動作しますが，そのほかの設定も必要に応じて変更してください．
　（PositLogConfig.pm の文字コードはUTF8です．文字コードは変更しないでください．）

　PositLogConfig.pmはPositLogのルートディレクトリ直下に設置してください．パーミションは644です．

----------------------------------------
(3) 必須ディレクトリを作成
----------------------------------------

　PositLogのルートディレクトリ直下に必須のディレクトリを作成します．

　admindata
　bgimages
　
　という名の2つのディレクトリをパーミッション777で作成してください．

　また，PositLogConfig.pm 内で設定したページデータ保存用ディレクトリ
　（$datapath）も777で作成してください．デフォルトでは pages という名前です．
　
　ここまでの作業の結果は，デフォルトの設定のままだと次のような構成になります．
　カッコ内はパーミッションです．

　PositLogルートディレクトリ (755)
　|- admindata (777)
　|- bgimages (777)
　|- pages (777)
　|
　|- PositLogConfig.pm (644)  

----------------------------------------
(4) ファイルのコピー
----------------------------------------

　positlog060rc1 ディレクトリ内の .cgi ファイルと .pmファイルを
　PositLogのルートディレクトリへ設置してください．
　
　アップロードする場合，とくに.cgiファイルについては改行コードがPerlのCGIとして実行できる
　形式でアップロードされているか注意してください．
　また，文字コードはUTF8ですのでそのままにしてください．

　移動すべきファイルと，パーミッション設定は次のようになります．
　PositLogルートディレクトリ (755)
　|- clearCache.cgi (755)
　|- createadmin.cgi (755)
　|- createPage.cgi (755)
　|- deleteSprite.cgi (755)
　|- fileloader.cgi (755)
　|- fileupload.cgi (755)
　|- groupSprite.cgi (755)
　|- pagerss.cgi (755)
　|- positlog.cgi (755)
　|- PositLogAuth.pm (644)
　|- PositLogConfig.pm (644)
　|- PositLogLink.pm (644)
　|- PositLogParam.pm (644)
　|- PositLogSprites.pm (644)
　|- recentcontents.cgi (755)
　|- saveSprite.cgi (755)
　|- saveStyles.cgi (755)
　|- tag.cgi (755)
　|- ungroupSprite.cgi (755)
　|- unlockPassword.cgi (755)


----------------------------------------
(5) ディレクトリのコピー
----------------------------------------

　positlog060rc1 ディレクトリ内にある，次のディレクトリとディレクトリに含まれるファイルを
　そのままPositLogのルートディレクトリへ設置してください．

　- admintools
　- extlib
　- lang
　- PositLogPlugin
　- system

　ディレクトリのパーミッションは755，ファイルのパーミッションは644にしてください．
　ただし，次の(6)で説明するファイルはパーミッションを755，あるいは777とします．


----------------------------------------
(6) パーミッションの追加設定
----------------------------------------

　次の.cgiファイルのパーミッションを755としてください．
　
　PositLogルートディレクトリ (755)
　|- admintool (755)
　|　　|- admin.cgi (755)
　|　　|- adminnavi.cgi (755)
　|　　|- admintop.cgi (755)
　|　　|- pagemanager.cgi (755)
　|　　|- pageproperty.cgi (755)
　|　　|- positlogadmin.cgi (755)
　|　　|- usermanager.cgi (755)
　|　　|- userproperty.cgi (755)
　|- system
　|　　|- fckeditor
　　　　　　|- editor
　　　　　　　　　|- filemanager
　　　　　　　　　　　　|- connectors
　　　　　　　　　　　　　　　|- perl (777) 
　　　　　　　　　　　　　　　　　|- connector.cgi (755)
　　　　　　　　　　　　　　　　　|- upload.cgi (755)


　system/fckeditor/editor/filemanager/connectors/perl/ ディレクトリは，
　CGIが実行される権限によって書き込み出来るようにしてください．

　また，繰り返し確認しますが，PositLogとして頒布される.cgiファイルは全て755としてください．
　とくに次の2つは深い場所にあるので忘れないようにしてください．
　system/fckeditor/editor/filemanager/connectors/perl/connector.cgi
　system/fckeditor/editor/filemanager/connectors/perl/upload.cgi


　アップロードする場合，.cgi，.pmファイルについては改行コードがPerlのCGIとして実行できる
　形式でアップロードされているか注意してください．
　また，文字コードはUTF8ですのでそのままにしてください．

------------------------------------------------
(7) admindataディレクトリへの.htaccessの設置
------------------------------------------------

　頒布ファイルにはadmindataディレクトリに置く.htaccessファイルを添付しています．
　htaccess_admindata という名前のファイルを .htaccessと名前を変えて，
　admindataディレクトリ直下に置いて下さい．

  なお，Windowsのエクスプローラでは通常 .htaccess という名前に変えることが出来ません．
　サーバへアップロードしてから，FTPソフト上でファイル名を変えるなど工夫してください．

　PositLogルートディレクトリ(755)
　|- admindata (777)
　|　　|- .htaccess (644)

-------------------------------------------
(8) ルートディレクトリへの.htaccessの設置
-------------------------------------------

　頒布ファイルにはルートディレクトリに置く .htaccessファイルのサンプルを
　同梱しています．htaccess と htaccess_mod_rewrite の２つがあります．
　いずれかを，.htaccessと名前を変えてからPositLogのルートディレクトリに置きます．
　
　サーバの設定によってはPositLogが動作しなくなることがありますので，
　設定を変えるか，.htaccessを置くのをやめてください．
　
(a) htaccess 

　最もシンプルなサンプルです．

- Options -Indexes

 この行では，PositLogのルートURL以下のディレクトリへアクセスしたとき，ディレクトリのファイル一覧を表示しないようにします．

- DirectoryIndex positlog.cgi index.html

　この行では，PositLogのルートURLにアクセスしたとき，
　positlog.cgi を呼び出すようにしています．もしもPositLogの管理画面で
　ホームページとして設定されているページがあれば，そのページが表示されます．
　（ホームページの説明　http://positlog.org/071208Yf.html#id_spr6eaob）
 
- AddHandler cgi-script .cgi .pm .dat .spr

　この行では，PositLogの構成ファイル，とくに.datや.sprファイルを
　URL指定で直接読めなくすることを意図したものです．

(b) htaccess_mod_rewrite

　RewriteEngine の設定を含むサンプルです．

　まずはサーバでmod_rewriteが利用可能であるかどうか確認してください．
　可能である場合，PositLogConfig.pm 内で $mod_rewrite = 1; としてから，
　本サンプルをご利用ください．PositLogConfig.pmにも説明がありますので参照してください．

　mod_rewriteが利用可能なサーバでは，本サンプルの設定を利用することにより
　ページのURLの
　positlog.cgi?load=000000XX の部分を 000000XX.html で置き換えたり
　タグをmicroformatsのrel-tagに対応させることが出来るようになります．
　（http://microformats.org/wiki/rel-tag）


----------------------------------------
(9) 管理者のユーザIDとパスワード設定
----------------------------------------
　createadmin.cgi をWebブラウザ上で開いてください．
　管理者（admin）用のユーザIDとパスワードを入力し，[Create] ボタンを押してください．
　管理者の認証用データとして，admindata の下に key.dat というファイルが作成されます．
　作成後，createadmin.cgiファイルはサーバから削除してください．
　管理者のユーザIDあるいはパスワードを忘れた際は，key.datを削除し，createadmin.cgiを再びアップロード，実行してください．

　createadmin.cgi が動作しない場合は，PositLogConfig.pm を書き間違えたか，正しく保存されていない場合があります．もう一度 PositLogConfig.pm をダウンロードして，別のエディタで編集，保存してみてください．（参考：http://positlog.org/080104Tu.html#id_spr8bxhu）


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



--------------------------------------------------------
--------------------------------------------------------
５．PositLog の開始
--------------------------------------------------------
--------------------------------------------------------

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

----------------------------------------
(1) 管理用ツールへログイン
----------------------------------------
　admintools/admin.cgi をWebブラウザ上で開いてください．
　ログイン画面が表示されますので，先ほどの管理者のユーザIDとパスワードを入力し，
　[Login] ボタンを押してください．管理画面へログインできます．

【注意】
　ブラウザが一時的なCookieを受け付けない設定では，正しくログインできません．
　一時的なCookieを利用可能としてください．


----------------------------------------
(2) 新しいページの作成
----------------------------------------

　まずはページを作成しましょう．
　「Create new page」という項目が管理画面のトップに表示されています．

　（参考）http://positlog.org/071208sA.html

　この項目の空欄にあたらしいページの名前を入れて，「Create this page」ボタンを押してください．
　
　ページが作成され，ページリスト（List）が表示されます．
　ページリストから「edit」リンクを辿ると，新しいページを編集することができます．
　ページリストから「open」リンクを辿ると，新しいページを閲覧することができます．

　（参考）http://positlog.org/071208Yf.html#id_spr9esau

　あとはWeb版のマニュアルをご覧下さい．
　http://positlog.org/071208Rq.html

　とくにセキュリティに関する項目はご一読およびご注意ください．
　http://positlog.org/071213gV.html

以上です．
