========== Readme.txt  for  BooTreeBBS ver1.08 ==========


＊BooTreeBBSは、Perlで記述された掲示板プログラムです。


＊このプログラムを使用する前に以下のことをご確認下さい。

　１．サーバーでＣＧＩを使用できること
　２．サーバーでＰｅｒｌを使用できること


＊利用方法

　１．まず以下のファイルを用意します。( )内はファイル名。
　　　BooTreeBBS　（btbbs.pl）
　　　BooAdmin    （btadmin.pl）
　　　jcode　　　 （jcode.pl）　

　２．次に btbbs.pl 、btadmin.pl の、それぞれの拡張子を pl
　　　から cgi に変更します。

　３．メモ帳などのエディタで、メッセージを格納するファイ
　　　ルを作ります。何も入ってない（書いてない）ファイル
　　　を作り、ファイル名を bdata.dat にします。（具体的
　　　にはエディタを起動した後、何も書かないで「ファイル
　　　名をつけて保存」します）

　４．btbbs.cgiを、エディタで開き、以下の部分を変更してく
　　　ださい。（変更箇所は先頭行と#set data部分です）　　

　　　＊先頭行の#! /usr/local/bin/perl の部分を 自分のサ
　　　　ーバーでのPerlへのパスに書き換えてください。分か
　　　　らない方は、サーバー管理者へお問い合わせください。

　　　＊$vmax = の''内は一画面に表示する記事数を指定しま
　　　　す。記事数がここで指定した数を超えると画面下部に
　　　　「前のＸ件」ボタンが表示され、そこから過去ログに
　　　　アクセスできます。

　　　＊$nmax = の''内は、最大メッセージ数です。この数より
　　　　メッセージ数が多くなると、自動的に古いメッセージ
　　　　から削除されます。お好きな数字に変更してください。

　　　＊$cgi = の''内は、ＢＢＳプログラム本体へのパスです。
　　　　ファイル名を変更した場合などは変更してください。

　　　＊$dat = の''内は、メッセージ格納用ファイルへのパス
　　　　です。 ファイル名を変更した場合や、別のディレクト
　　　　リへ置く場合などは変更してください。

　　　＊$admin = の''内は、管理者用プログラムへのパスです。
　　　　ファイル名を変更した場合や、別のディレクトリへ置
　　　　く場合などは変更してください。

　　　＊$bbstitle = の''内は、ＨＴＭＬの<title></title>タ
　　　　グの中に入る文字を書きます。

　　　＊$head = の''内は、掲示板の最上部中央にタイトルと
　　　　して表示される部分です。HTMLタグを使用できますの
　　　　で、<h1>タグや<font>タグなど、いろいろな設定が可
　　　　能です。もちろん画像の挿入もできます。
　　　　画像をタイトルとして使用したい場合は、下のように
　　　　HTMLの<img>タグを挿入してください。（画像は仮に
　　　　title.gifとします）
　　　　$head = '<img src="./title.gif">';

　　　＊$linkname = の''内は、掲示板に埋め込むリンクの名
　　　　前（ファイルへのパスではない）です。掲示板から、
　　　「ホームページに戻る」といったリンクなどにご利用く
　　　　ださい。

　　　＊$linkurl = の''内は、掲示板に埋め込むリンクのリ
　　　　ンク先ファイルへのパスです。$linknameとあわせて
　　　　ご利用ください。

　　　＊$back = の''内では、掲示板の背景を設定します。
　　　　HTMLのBODYタグ内での設定と同じ記述で指定するこ
　　　　とができます。
　　　（bgcolor="#000000" や background="image.gif"等）
　　　　bgcolorとbackgroundの両方を指定することもでき、
　　　　その際はHTMLの記述と同じく半角スペースを間に入れ
　　　　てください。

　　　＊$linkc = の''内は、掲示板ページ全体の文字の色や
　　　　リンク色などの設定をします。HTMLのBODYタグ内での
　　　　設定と同じ記述で指定することができます。

　　　＊$nomail = の''内は、メールアドレスが入力されなか
　　　　ったときの、書込内容の名前部分の色を指定（#000000
　　　　〜 #ffffff）します。

　　　＊$rmvc = の''内は、削除済み記事のタイトル色を指定
　　　（#000000 〜 #ffffff）します。

　　　＊$type = の''内は、t か b を 記入します。t を記入
　　　　すると書き込みフォームが記事表示部分より上に表示
　　　　され、b を記入すると書き込みフォームが記事表示部
　　　　分より下に表示されます。デフォルトはbです。

　　　＊$autolink = の''内は、on か onw か off を記入しま
　　　　す。onにすると投稿本文中のＵＲＬやメールアドレス
　　　　を自動的にリンク処理します。onwにはonと同様の処理
　　　　をしますが、ＵＲＬへのリンク時に別ウインドウを開
　　　　きます。
　　　　ただし、ＵＲＬやメールアドレスの前後に半角英数が
　　　　ある場合など、それを含んだリンクになることがあり
　　　　ます。

　　　＊$pmark = の''内は、記事スレッドの親記事につける
　　　　マークなどを指定します。ＨＴＭＬタグを記載できま
　　　　すので画像の指定も可能です。

　　　＊$cmark = の''内は、記事スレッドの子記事につける
　　　　マークなどを指定します。ＨＴＭＬタグを記載できま
　　　　すので画像の指定も可能です。

　　　＊$timetext = の''内は、記事スレッドの時刻部分のフ
　　　　ォントオプションを指定します。ＨＴＭＬのFONTタグ
　　　　で使えるオプションでの指定が可能です。

　　　＊$new = の''内は、どのくらい記事が新しい時に、そ
　　　　の記事を強調して表示するかを指定します。
　　　　ここで指定した日数分の最近の記事は書き込み時刻部
　　　　分が$newtextで指定したフォントオプションで強調さ
　　　　れます。

　　　＊$newtext = の''内は、上の$newで指定した日数分の
　　　　最近の記事を強調するための、書き込み時刻部分のフ
　　　　ォントオプションを指定します。ＨＴＭＬのFONTタグ
　　　　で使えるオプションでの指定が可能です。
　　　　なお、$timetextで指定したオプションは $newtextで
　　　　は指定しないでください。

　　　＊$topnew = の''内は、新しい書き込みのあった記事ス
　　　　レッドを、常に掲示板先頭に表示したい場合はonを指
　　　　定します。それ以外の場合はoffを指定します。

　　　＊$rmnews = の''内は、管理者によって削除された記事
　　　　の表示上のタイトルを指定します。

　６．btadmin.cgiをエディタなどで開き、以下の部分を変更し
　　　てください。（変更箇所は先頭行と#set data部分です）

　　　＊先頭行の#! /usr/local/bin/perl の部分を 自分のサ
　　　　ーバーでのPerlへのパスに書き換えてください。分か
　　　　らない方は、サーバー管理者へお問い合わせください。

　　　＊$bbs = の''内は、ＢＢＳプログラムファイルへのパス
　　　　です。ファイル名を変更した場合や、別のディレクトリ
　　　　へ置く場合などは変更してください。

　　　＊dat = の''内は、メッセージ格納用のファイルへのパス
　　　　です。ファイル名を変更した場合や、別のディレクトリ
　　　　へ置く場合などは変更してください。

　　　＊pwd = の''内は、メッセージ削除用のパスワードの指定
　　　　です。デフォルトのままでの使用はしないでください。
　　　　必ず変更をお願いします。

　　　＊$head = の''内は、管理者用ページの最上部中央にタ
　　　　イトルとして表示される部分です。HTMLタグを使用で
　　　　きますので、<h1>タグや<font>タグなど、いろいろな
　　　　設定が可能です。もちろん画像の挿入もできます。
　　　　画像をタイトルとして使用したい場合は、下のように
　　　　HTMLの<img>タグを挿入してください。（画像は仮に
　　　　title.gifとします）
　　　　$head = '<img src="./title.gif">';

　　　＊$back = の''内では、管理者用ページの背景を設定し
　　　　ます。HTMLのBODYタグ内での設定と同じ記述で指定す
　　　　ることができます。
　　　（bgcolor="#000000" や background="image.gif"等）
　　　　bgcolorとbackgroundの両方を指定することもでき、
　　　　その際はHTMLの記述と同じく半角スペースを間に入れ
　　　　てください。

　　　＊$linkc = の''内は、管理者用ページ全体の文字の色
　　　　やリンク色などの設定をします。HTMLのBODYタグ内
　　　　での設定と同じ記述で指定することができます。

　　　＊$rmnews = の''内は、管理者によって削除された記事
　　　　の表示上のタイトルを指定します。

　７．btbbs.cgi と btadmin.cgiを、 サーバーにasciiモードで転
　　　送します。
　　 （ＣＧＩプログラムの設置場所をプロバイダ側で指定し
　　　ている場合がありますので、分からない場合はサーバ
　　　ー管理者にお問い合わせください）

　８．btbbs.cgi と btadmin.cgi があるディレクトリに「lock」
　　　という名前のディレクトリを作成します。このディレク
　　　トリには、何も入れなくてかまいません。

　９．btbbs.cgi と btadmin があるディレクトリに jcode.pl を
　　　ASCIIモードで転送します。

　10．btbbs.cgiがあるディレクトリに bdata.dat を転送します。


　11．以下のようにパーミッションを設定します。
 　　（パーミッションの設定方法についてはＦＴＰソフトの
　　　 操作説明をお読みください）
　　　　lock <dir>　→　777
　　　　btbbs.cgi 　→　755
　　　　btadmin.cgi →　755
　　　　bdata.dat　 →　666
　　　　jcode.pl　　→　644

　　　パーミッションの設定方法例
　　　｜　FTP.exeを使用する場合
　　　｜　例）ftp>quote site chmod 755 btbbs.cgi


　12．掲示板へのリンクは、リンク先に btbbs.cgi のパスを指定
　　　してください。


＊ご注意

　BooTreeBBSはフリーソフトウエアですが、寄付は歓迎します
　送金いただける場合、下記アドレスまでメールをお送りくだ
  さい。送金先をご連絡させていただきます。

　利用などに当たっては「ＣＧＩご利用上のルール」（下記Ｕ
　ＲＬ参照）に記載されているすべてのルールが適用されます
　ので、同意の上ご利用ください。

　・ＣＧＩご利用上のルール
　http://www.booboo.ne.jp/contents/cgi/rule/

　当プログラムの使用により生じたトラブルもしくはそれに伴
　う損害に対し、制作者は一切責任を負いません。


＊著作・制作

　ＢｏｏＢｏｏＣｌｕｂ
　E-mail: booboo@booboo.ne.jp
　ＵＲＬ: http://www.booboo.ne.jp/

　お問い合わせ詳細
　http://www.booboo.ne.jp/contents/calendar/index.html


＊お願い
　バグレポート、ご感想、お問い合わせなどありましたら、
　上記アドレスまでメールをお願いいたします。


＊バージョンアップ履歴

・Ver1.00
　１,各種不具合の修正
　２,フォームと記事の位置設定機能追加
　３,一定件数毎の過去ログ閲覧機能追加

・Ver1.01
　１,削除済記事のタイトル色設定の不具合を修正
　２,内部処理を一部修正

・Ver1.02
　１,改行処理を修正

・Ver1.03
　１,設定項目を一部修正

・Ver1.04
　１,オートリンクで別ウインドウを開く設定追加

・Ver1.05
　１,一部レイアウトの変更
　２,新記事強調機能の追加
　３,新記事表示位置変更機能の追加

・Ver1.06
　１,新記事強調機能の不具合を修正

・Ver1.07
　１,削除済み記事サブジェクト設定機能を追加

・Ver1.08
　１,内部処理用タイムゾーン設定の追加